wxauto-mcp

# wxauto MCP Server 微信自动化 MCP (Model Context Protocol) 服务器，为 AI 开发工具提供微信自动化能力。 [](https://www.python.org/downloads/) [](LICENSE) [](https://modelcontextprotocol.io/) ## 功能特性 - **MCP 协议支持**: 完整支持 Model Context Protocol - **消息操作**: 发送文本、图片、文件、链接卡片消息 - **联系人管理**: 获取好友列表、切换聊天、获取聊天信息 - **会话管理**: 获取会话列表、筛选未读消息 - **文件传输**: 发送单个或批量文件 - **好友管理**: 获取新好友请求、接受好友、添加新好友 - **多种传输**: 支持 stdio、HTTP/SSE 传输方式 - **AI 工具集成**: 支持 Claude Code、Cursor 等开发工具 - **一键安装**: 自动配置到 AI 应用，无需手动编辑配置文件 - **全局单例**: 自动检测并复用已运行的服务器实例，避免资源浪费和冲突 ## 系统要求 - Windows 11/10 - Python 3.11+ - 微信已登录 - wxautox4 激活 ## PyPI 自动发布 本项目已配置 PyPI Publishing，推送版本标签即可自动发布： ```bash # 发布新版本 git tag v1.0.1 git push origin v1.0.1 ``` GitHub Actions 会自动构建并创建 Release，PyPI 会自动发布新版本。 ## 快速安装 ```bash pip install wxauto-mcp ``` ## 使用 ### 一键自动安装（推荐） ```bash wxauto-mcp --install ``` 这将自动配置 MCP Server 到 **Claude Desktop** 和 **Claude Code**，无需手动编辑配置文件。 ### 生成配置文件 ```bash # 生成配置文件到默认目录 (./mcp-configs) wxauto-mcp --config # 生成配置文件到指定目录 wxauto-mcp --config /path/to/configs ``` ### 手动配置 如果需要手动配置，运行： ```bash wxauto-mcp --config mcp-configs ``` 然后将生成的配置文件内容添加到 AI 应用中： **Claude Desktop** 配置文件位置： - Windows: `%APPDATA%\Claude\claude_desktop_config.json` **Claude Code** 配置文件位置： - `%USERPROFILE%\.claude.json` **Cursor**：在 Settings 的 MCP 配置中添加 ### 启动服务器 ```bash # stdio 模式 (默认，用于 MCP 客户端) wxauto-mcp # HTTP/SSE 模式 wxauto-mcp-http --port 8000 # 指定主机和端口 wxauto-mcp-http --host 0.0.0.0 --port 9000 ``` ## 可用工具（27个） ### 系统工具（6个） - `wechat_initialize` - 初始化微信连接 - `wechat_status` - 获取微信运行状态 - `wechat_activate` - 激活 wxautox4 - `wechat_check_activation` - 检查激活状态 - `wechat_list_tools` - 列出所有可用工具 - `get_my_info` - 获取我的微信账号信息 ### 消息工具（6个） - `send_message` - 发送文本消息 - `send_url_card` - 发送链接卡片 - `get_messages` - 获取当前聊天消息 - `get_history` - 获取历史消息 - `ge…