wxauto MCP Server

微信自动化 MCP (Model Context Protocol) 服务器，为 AI 开发工具提供微信自动化能力。

系统要求

• Windows 11/10
• Python 3.9+
• 微信已登录
• wxautox4 激活

快速安装

pip install wxauto-mcp

使用

一键自动安装（推荐）

wxauto-mcp --install

这将自动配置 MCP Server 到 Claude Desktop 和 Claude Code，无需手动编辑配置文件。

生成配置文件（手动配置）

如果需要手动配置，运行：

# 生成配置文件到默认目录 (./mcp-configs)
wxauto-mcp --config

# 生成配置文件到指定目录
wxauto-mcp --config /path/to/configs

wxauto-mcp --config mcp-configs

然后将生成的配置文件内容添加到 AI 应用中：

Claude Desktop 配置文件位置：

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code 配置文件位置：

• %USERPROFILE%\.claude.json

Cursor：在 Settings 的 MCP 配置中添加

可用工具（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 - 获取历史消息
• get_next_new_message - 获取下一个聊天窗口的新消息
• send_bulk_messages - 批量发送消息

联系人工具（3个）

• get_friends - 获取好友列表
• get_chat_info - 获取当前聊天信息
• switch_chat - 切换聊天窗口

会话工具（4个）

• get_sessions - 获取会话列表
• get_recent_groups - 获取最近群聊
• filter_sessions - 筛选会话列表
• get_unread_sessions - 获取有未读消息的会话

文件工具（4个）

• send_files - 发送文件
• send_image - 发送图片
• send_directory_files - 发送整个目录的文件
• check_file_exists - 检查文件是否存在

好友请求工具（3个）

• get_new_friends - 获取新的好友请求列表
• accept_new_friend - 接受新的好友请求
• add_friend - 添加新好友

界面工具（1个）

• switch_to_contact - 切换到联系人页面

常见问题

1. 激活

wxautox4 需要激活使用。请访问 https://docs.wxauto.org 获取激活密钥，然后：

# 设置环境变量
set WECHAT_LICENSE_KEY=your-license-key

# 或调用激活工具
wxauto-mcp-http
# 然后调用 wechat_activate 工具

2. 权限问题

确保 Python 有访问微信进程的权限，建议以管理员身份运行。

3. 微信窗口

某些操作需要微信窗口在前台可见，请确保微信窗口未被最小化。

4. 配置文件位置

不同 AI 工具的配置文件位置：

Claude Desktop:

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Claude Code:

• Windows: %USERPROFILE%\.claude.json

Cursor:

• 在 Settings → MCP 中添加配置

联系方式

• GitHub Issues: louxinghao@gmail.com