← 返回目录
W

WeChat MCP Server

社区
让 AI 助手读取和回复微信消息的 MCP 服务器
分类
其他 第 158 / 230
Stars
★ 276 热门
传输方式
stdio(本地进程) · SSE · Streamable HTTP
运行环境
Python 3.12+
凭据
无需凭据
许可证
MIT
最近提交
⚠
工具数
4
49FMRS · D

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

最强项 · 安装易用性 13/20 最弱项 · 可靠性 8/20

可靠性
8/20
安全与权限
8/20
维护活跃度
8/20
文档质量
12/20
安装易用性
13/20
查看各项评分依据
可靠性 8/20
提供的证据仅为 README 与仓库元数据;没有源码、测试、CI 或可运行产物。README 描述了看似合理的 stdio/streamable-http/SSE 服务与四个工具,但无法验证工具与真实行为是否一致,也看不到错误处理细节。扣分:缺少提交的测试与 CI、缺少故障模式文档,且依赖 macOS Accessibility API 与屏幕捕获,启动是否干净无法确认。因无执行证据,分数保持在 12 分静态上限之下。
安全与权限 8/20
所提供的材料中未见红线问题。主要风险明确:辅助功能 API 与屏幕捕获对微信/屏幕内容有广泛读取权限,工具还能发送回复、加好友、发布朋友圈。README 提到朋友圈草稿模式与加好友隐私可配置,但没有说明确认机制、最小权限范围、凭据/数据流向或外联行为。因此按“风险可见但权限/确认/范围不完整”给分;无源码可进一步核查。
维护活跃度 8/20
仓库未归档且采用 MIT 许可,README 引用了 PyPI 包和文档,说明项目有一定结构。但提供的元数据中没有提交频率、发布历史、issue 响应证据、依赖更新策略或安全响应渠道;10 个未关闭 issue 无法评估。星标仅作为发现信号,不计分。因维护治理证据缺失而扣分。
文档质量 12/20
README 提供了安装命令、客户端配置示例(Claude Code、Claude Desktop、Codex)、传输方式、工具名称、macOS 权限步骤,并链接了详细指南与子代理文档,作为第一层文档可用。扣分:缺少故障排查、除 macOS/微信外的明确限制说明、错误/成本/限额细节;链接的详细文档未随附,无法核实,仍存在隐含假设。
安装易用性 13/20
安装步骤文档化:pip 安装、在主流客户端注册 stdio 命令、授予辅助功能权限、运行微信。提供了三种客户端配置示例,这一点较好。扣分:仅支持 macOS,依赖已运行的微信与手动授予的系统权限,且没有自动化依赖检查或验证过的端到端流程;未提供 CI/测试,因此按静态校准将安装分控制在 15 分以下。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络控制浏览器

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境:Python 3.12+

  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 版已安装并运行。

验证是否装好

在终端授予辅助功能权限并启动 wechat-mcp 后,在客户端的工具列表中应能看到 fetch_messages_by_chat 等工具;也可让 AI 获取任一聊天的新消息来验证连接。

常见排障

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

试试这样问

连接成功后,可以直接对 AI 助手这样说:

  • 帮我查看和某个联系人的最近聊天记录
  • 根据刚才的聊天内容,帮我回复一条消息
  • 用我的微信ID好友申请添加一个新联系人
  • 发一条纯文字朋友圈,先只存草稿不要发布

工具能力 4

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

使用场景

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

支持客户端

Claude Desktop
Claude Code
Codex
OpenClaw部分支持
ChatGPT部分支持

依据项目文档列出,未经本站实测。

详细介绍

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

同类可选方案

BioMCP 75 · B

统一的命令行语法,接入约30个可信生物医学数据源。

★ 654 · 工具数 11 与当前对比 →

源版本 cc470367ca66 数据同步于 2026-10-12 查看 FMRS 评分方法