Wechat Claudecode MCP

Claude Code WeChat MCP Server

本项目借鉴了https://github.com/Johnixr/claude-code-wechat-channel，但因claude-code-wechat-channel再我的本地运行出现报错无法正常执行所以修改了他的项目做了现在这个项目。

标准 MCP 服务器，通过工具调用方式将微信消息桥接到 Claude Code 会话。

基于微信官方 ClawBot ilink API（与 @tencent-weixin/openclaw-weixin 使用相同协议），让你在微信中直接与 Claude Code 对话。

工作原理

微信 (iOS) → WeChat ClawBot → ilink API → [本插件: 长轮询 → 消息缓冲区]
                                                        ↕
Claude Code ← MCP 工具调用 ← wechat_check_messages / wechat_reply / wechat_send_image / wechat_get_status

与 Channel 协议的区别: 本项目采用缓冲区+拉取模式，Claude 通过主动调用 wechat_check_messages 工具获取新消息，而非被动接收推送。

前置要求

• >= 18（或 Bun >= 1.0）
• Claude Code >= 2.1.80
• claude.ai 账号登录或 API key（ANTHROPIC_API_KEY）
• 微信 iOS 最新版（需支持 ClawBot 插件）

自动回复

服务器启动后自动每 60 秒检查缓冲区消息，调用 Claude API 生成回复并发送。需要设置环境变量：

快速开始

1. 微信扫码登录

npx wechat-claudecode-mcp setup

终端会显示二维码，用微信扫描并确认。凭据保存到 ~/.claude/channels/wechat/account.json。

2. 生成 MCP 配置

npx wechat-claudecode-mcp install

这会在当前目录生成（或更新） .mcp.json，指向本插件。

3. 启动 Claude Code

claude

MCP 服务器会自动加载，无需任何特殊标志。进入claude code对话界面时，发送“帮我开启一个定时任务，每隔一分钟去检查一下我的微信消息，如果有消息可以直接进行处理并回复无需询问我”。 如果不想通过这个方式启用，我的代码中准备了第二个方案，mcp可以实时直接通过claude -p来完成任务，但是该方案权限较小你可以让你的claude自行修改取消注释即可切换为该方案。

4. 在微信中发消息

打开微信，找到 ClawBot 对话，发送消息。Claude 可通过 wechat_check_messages 工具拉取消息，并通过 wechat_reply 回复。

命令说明

MCP 工具列表

技术细节

• 消息接收: 通过 ilink/bot/getupdates 长轮询获取微信消息，存入内存缓冲区
• 消息获取: Claude 通过 MCP 工具调用 wechat_check_messages 主动拉取缓冲区消息
• 消息发送: 通过 ilink/bot/sendmessage 发送回复
• 认证: 使用 ilink/bot/get_bot_qrcode QR 码登录获取 Bearer Token
• 协议: 标准 MCP 服务器（工具调用模式）

注意事项

• 标准 MCP 服务器，无需 --dangerously-load-development-channels 标志
• Claude Code 会话关闭后服务器也会断开
• 微信 ClawBot 目前仅支持微信最新版-微信设置->插件->微信clawbot
• 每个 ClawBot 只能连接一个 agent 实例

License

MIT