← 返回目录
W

WeChat MCP Server

社区
让 AI 助手读取和回复微信消息的 MCP 服务器
GitHub 源仓库 ↗
★ 244 Stars 分类 · 其他 热门 源版本 cc470367ca66
49FMRS · D
可靠性
8/20
安全与权限
8/20
维护活跃度
8/20
文档质量
12/20
安装易用性
13/20

WeChat MCP Server 是一个功能丰富的 MCP 服务器,专为 macOS 用户设计,利用辅助功能 API 控制微信。它提供了消息获取、回复、添加联系人、发布朋友圈等实用工具,并集成了 5 个 Claude Code 子代理以增强自动化能力。安装相对简单,但需要仔细配置权限。

查看 FMRS 评分方法 →

WeChat MCP Server 是一个基于 macOS Accessibility API 和屏幕捕获的 MCP 服务器,使 LLM 能够编程式地与微信聊天交互。它支持获取任意聊天(联系人或群聊)的最近消息、发送自动回复、发布纯文本朋友圈(可选草稿模式)、通过微信 ID 添加联系人(可配置隐私)、精确名称匹配的智能聊天搜索,并包含 5 个专为微信自动化设计的 Claude Code 子代理。

工具能力

fetch_messages_by_chat
获取指定聊天的最近消息
reply_to_messages_by_chat
向聊天发送回复
add_contact_by_wechat_id
使用微信 ID 添加联系人并发送好友请求
publish_moment_without_media
发布纯文本朋友圈(无照片或视频);可选只准备草稿而不发布(publish=False)

安装接入

  1. 安装:pip install wechat-mcp-server
  2. 使用 Claude Code 配置:claude mcp add --transport stdio wechat-mcp -- wechat-mcp(使用 pip 安装时)或 claude mcp add --transport stdio wechat-mcp -- uv --directory $(pwd) run wechat-mcp(使用 uv 开发时)。
  3. 或者使用 Claude Desktop 配置 JSON(见 README)。
  4. 或者使用 Codex 配置:codex mcp add wechat-mcp -- wechat-mcp
  5. 授予终端辅助功能权限:系统设置 → 隐私与安全性 → 辅助功能,添加你的终端应用。
  6. 确保微信 Mac 版已安装并运行。

选型与风险

适合谁

  • macOS 用户
  • 使用 Claude Code 或 Claude Desktop 的开发者
  • 需要微信自动化集成的个人或团队
  • 熟悉命令行和 Python 环境的用户

不适合谁

  • 非 macOS 平台(Windows、Linux)
  • 没有微信 Mac 版或未授予辅助功能权限的用户
  • 需要处理媒体文件(图片、视频)的朋友圈发布
  • 需要跨设备或移动端支持的用户

所需权限

  • macOS 辅助功能权限(用于控制微信)
  • 需要微信 Mac 版已安装并运行

风险与副作用

  • 依赖 macOS Accessibility API,可能受系统更新影响
  • 需要授予终端辅助功能权限,存在安全风险
  • 微信界面的变化可能导致工具失效
  • 自动化操作可能违反微信服务条款
  • 使用辅助功能控制微信可能被微信检测为自动化行为

常见排障

  1. 确保已授予终端辅助功能权限(系统设置 → 隐私与安全性 → 辅助功能)
  2. 确保微信 Mac 版已安装并正在运行
  3. 检查 Python 版本是否符合要求(3.12+)
  4. 使用 uv 开发时,确保已执行 `uv sync`
  5. 尝试不同传输方式(stdio、sse、streamable-http)

使用场景

自动化回复微信消息
监控聊天并汇总信息
智能搜索聊天历史
发布朋友圈草稿
通过 AI 管理联系人

支持客户端

Claude Desktop完整支持
Claude Code完整支持
Codex完整支持
Openclaw部分支持
ChatGPT部分支持