WeChatFerry 聊天 MCP 工具：让 AI 直接操控微信

标签: WeChatFerry / MCP / 微信 / Claude Code / Codex
原文: 微信公众号「码农先森」https://mp.weixin.qq.com/s/7beFlecXuJiUHiBXFRcMAg

核心亮点

基于 WeChatFerry 的聊天 MCP 工具，让 Claude Code、Codex 等 AI 编程工具直接操控微信：发消息、管群聊、接收转账！

这是一个把微信变成 AI 工具的 MCP 服务——通过标准的 MCP 协议，让你的 AI 编程助手直接操作微信，实现自动发消息、管理群聊、接收转账等功能。

MCP 工具列表

账号管理

工具	作用
`check_login_status`	查询当前微信是否已登录
`get_self_wxid`	获取当前登录账号的 wxid
`get_self_info`	获取当前登录账号的详细信息

消息操作

工具	作用
`send_text_message`	发送文本、卡片、网络图片或文件消息到个人或群聊
`get_message_types`	查看微信客户端支持的消息类型字典
`revoke_message`	根据消息 ID 撤回已发送的消息
`forward_message`	将历史消息转发给指定联系人或群聊
`send_pat_message`	在群聊中拍一拍指定成员

群聊管理

工具	作用
`get_chat_rooms`	列出账号加入的所有群聊
`get_chat_room_members`	查询指定群聊的成员列表
`get_chat_room_alias`	查询群聊中某位成员的群昵称
`invite_chat_room_members`	通过邀请方式将成员加入群聊
`add_chat_room_members`	直接拉取联系人加入群聊
`remove_chat_room_members`	将指定成员移出群聊

通讯录与好友

工具	作用
`get_contacts`	获取完整通讯录
`get_friends`	获取好友列表
`get_info_by_wxid`	通过 wxid 查询联系人信息
`refresh_moments`	刷新朋友圈数据
`accept_new_friend`	根据好友申请参数通过请求

转账

工具	作用
`receive_transfer`	接收好友发起的转账

安装方式

方法一：下载预编译版本

访问 GitHub Releases 页面下载编译版本。

方法二：从源码编译

# 克隆仓库
git clone https://github.com/lw396/wechat-mcp.git
cd wechat-mcp

# 安装依赖
go mod tidy

# 编译（Windows）
GOOS=windows GOARCH=amd64 go build -o wechat-mcp.exe .

# 运行
./wechat-mcp.exe

MCP 客户端接入

确保 wechat-mcp 服务已运行，默认地址：http://localhost:10888/mcp

Codex CLI

# 添加 HTTP MCP 服务器
codex mcp add --url http://localhost:10888/mcp wechat-mcp

# 检查是否添加成功
codex mcp list

Claude Code CLI

claude mcp add --transport http wechat-mcp http://localhost:10888/mcp
claude mcp list

VSCode

安装 Model Context Protocol 客户端扩展，在 settings.json 中配置：

"modelcontextprotocol.servers": [
  {
    "id": "wechat-mcp",
    "transport": {
      "type": "http",
      "url": "http://localhost:10888/mcp"
    }
  }
]

保存后通过命令 "MCP: Reload Servers" 重新加载。

其他支持 HTTP MCP 的客户端

任何支持 HTTP MCP 协议的客户端都可以连接，基本配置模板：

{
  "name": "wechat-mcp",
  "url": "http://localhost:10888/mcp",
  "type": "http"
}

常见问题

问题	说明
暂不支持 macOS/linux	目前仅在 Windows 环境下使用
微信版本要求	仅支持微信版本 v3.9.12.55，可前往 wechat-windows-versions 下载