AI导哈

微信消息桥接服务

通过MCP工具调用将微信消息桥接到Claude Code会话的服务，实现微信与Claude Code的交互。

  • by HaoNan-0331
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 HaoNan-0331/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 工具获取新消息，而非被动接收推送。

前置要求

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

自动回复

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

环境变量 说明
ANTHROPIC_API_KEY 或 ANTHROPIC_AUTH_TOKEN API 密钥（必需，未设置则自动回复禁用）
ANTHROPIC_BASE_URL API 基础 URL（默认 https://open.bigmodel.cn/api/anthropic）
CLAUDE_MODEL 或 ANTHROPIC_MODEL 模型名称（默认 GLM-5.1）

快速开始

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 回复。

命令说明

命令 说明
npx wechat-claudecode-mcp setup 微信扫码登录
npx wechat-claudecode-mcp install 生成 .mcp.json 配置
npx wechat-claudecode-mcp mcp-server 启动 MCP 服务器
npx wechat-claudecode-mcp help 显示帮助

MCP 工具列表

工具名称 说明
wechat_check_messages 检查并获取缓冲区中的新消息（调用后清空缓冲区）
wechat_reply 发送纯文本回复
wechat_send_image 发送本地图片
wechat_get_status 获取服务器状态（缓冲区消息数、连接状态等）

技术细节

  • 消息接收: 通过 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

相关 MCP