ChatGPT WeChat MCP Events Bridge
Integrates with ChatGPT Work event automations by delivering WeChat message events over MCP and exposing event-bound reply tools, enabling automations to generate and send responses back to WeChat.
Integrates with WeChat via iLink to receive messages from a dedicated account, expose them as MCP events, and send idempotent replies back to the original sender.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
ChatGPT WeChat MCP Events Bridge
一个独立、无模型的微信 iLink transport:把微信 ClawBot 收到的消息转换为 MCP Event,交给 ChatGPT Work 自动化生成回复,再通过事件绑定的幂等工具发回微信。
用任意一个微信号扫码授权 ClawBot 即可,不需要专门注册新号。注意一个微信号只能绑定一个 ClawBot,如果你的主号已经接了别的 Bot,可以换一个号来接。
非官方实验项目,与 OpenAI、腾讯或微信没有隶属关系。请仅在你有权使用的账号和环境中部署,并自行确认相关服务条款、隐私与合规要求。
架构
微信 ClawBot(扫码授权的微信号)
│ iLink getupdates / sendmessage
▼
本项目(无模型 transport)
├─ 有界图片/文件下载、解密与私有存储
├─ 持久化事件与订阅
├─ MCP 2.0 + OAuth DCR/PKCE
├─ Standard Webhooks 签名投递
├─ 写回确认门控的串行事件队列
├─ pending 队列与受控重投
├─ 精确绑定原事件的独立恢复事件
└─ 事件绑定、幂等的回复工具
│
▼
ChatGPT Work 事件自动化
└─ 负责上下文、推理、工具调用与最终回复transport 本身不运行语言模型,也不接管 ChatGPT 的上下文或记忆。
Related MCP server: mcp-server-wechat-mp
ChatGPT 端适用范围
本项目已在 ChatGPT Work 网页端跑通。官方 MCP Events 文档还列明支持 Work Desktop Cloud 和 dot。2026-10-30,在本账号网页普通 Chat 的全新独立模拟测试中,普通 MCP 工具可以调用,但事件订阅返回 404 Action not found,未生成订阅;因此普通 Chat 的微信事件唤醒尚未验证通过。
ChatGPT 环境 | 证据 | 本项目适用性 |
Work(网页) | 本项目实际跑通;官方文档列明支持 MCP Events | 已验证适用 |
Work(桌面端选择 Cloud) | 官方文档列明支持 MCP Events;本项目未单独实测 | 文档支持,未单独验收 |
dot | 官方文档列明支持 MCP Events;本项目未单独实测 | 文档支持,未单独验收 |
普通 Chat | 2026-10-30 本账号网页端可调用普通 MCP 工具,但未建立事件订阅 | 微信事件唤醒尚未验证通过 |
普通 Chat 实测记录
2026-10-30 使用全新、独立的 simulation-only POC 在本账号网页普通 Chat 中测试。POC 端点可发现,get_poc_status 也能正常返回;但尝试建立 poc.test.created 事件订阅时,Chat 宿主的订阅动作返回 404 Action not found,没有生成 subscription_id,POC 服务端订阅数仍为 0。失败点不是 POC 端点不可达,而是当次普通 Chat 未能建立事件订阅;这是一项带日期和账号范围的实测结果,不代表未来版本的永久结论。
插件在目录中可见或普通工具可调用,都不等于 MCP Events 已接通。
如果必须使用普通 Chat,只能另行设计轮询,或由外部后端主动调用模型/API;这两种方案都不等同于 MCP Events 对既有聊天窗口的原生事件唤醒。
主要能力
wechat.message.receivedMCP Event,支持文本、语音转写、图片和常见文件,并可按channel_id和发送者过滤。wechat.delivery.recoveryMCP Event:主任务在确认期限内没有成功写回时,只把原事件 ID 和必要的有界消息元数据交给独立恢复任务。get_transport_status:只读、脱敏的健康状态和计数。get_delivery_diagnostics:按事件 ID 区分 callback 未到、callback 已接受但没有写回回执,以及写回已成功/失败。get_pending_wechat_messages:读取最早的未成功回复事件,不返回 iLinkcontext_token。get_wechat_image:按事件 ID 与零起始索引读取一张已校验图片,以 MCP image content block 返回。get_wechat_file:按事件 ID 与零起始索引读取一个已校验文件,返回原始 MCP resource、可用的提取文字,并为音频附加 audio content block。send_wechat_reply:只能回复事件原发送者,使用reply:<event_id>幂等键。webhook 签名、回调地址校验、有限重试、重启后持久化。
入站去重、并发幂等写、机器人消息回环保护。
新事件按顺序投递;上一事件出现成功写回回执后才投递下一事件。回执超时时以新的 webhook delivery ID 重投同一原事件,仍强制使用原事件幂等键。
图片最多每事件 4 张、每张 20 MiB,仅允许 HTTPS 可信媒体主机,并校验 PNG/JPEG/GIF/WebP 内容;媒体 URL、解密密钥与图片字节不会进入 webhook 事件。
文件最多每事件 4 个、每个 25 MiB,支持 PDF、DOCX、TXT、PPTX、XLSX、XLS、CSV、TSV 和常见音频;仅公开成功/失败计数,URL、密钥、文件名和字节不会进入 webhook 事件。
DOCX/PPTX/XLSX 采用有界 OOXML 文本提取,限制 ZIP 条目数、单项和总解压大小,并拒绝路径穿越、符号链接、重复/加密条目、伪造扩展名与损坏密文。
自然分片:按段落、列表与句末标点切分,单片上限 3,800 字符。
安全默认值
TRANSPORT_MODE=simulationTRANSPORT_POLLING_ENABLED=false仅监听
127.0.0.1运行状态、账号令牌、OAuth token、webhook secret 和消息上下文只存入被忽略的
runtime/图片和文件仅存入隔离的运行状态目录,目录和文件采用私有权限;文件总配额 1 GiB,最多随最近 500 个事件保留 30 天
测试全部使用 fake iLink 与 fake webhook,不访问真实微信
本地验证
需要 Node.js 22.13 或更高版本。
npm install
npm run check当前回归集包含 50 项测试,覆盖图片/文件读取、OOXML 类型与富文本提取校验、ZIP 防护、音频容器校验、配额清理与并发写入、升级前去重键与历史事件兼容、串行确认门控、可配置事件重投、独立定向恢复、恢复订阅切换与幂等写回。
启动默认关闭真实网络访问的模拟服务:
.\scripts\start-simulation.ps1Linux 可直接设置安全的临时路由令牌并启动模拟服务:
TRANSPORT_ROUTE_TOKEN="$(node -e "console.log(require('node:crypto').randomBytes(36).toString('base64url'))")" TRANSPORT_MODE=simulation TRANSPORT_POLLING_ENABLED=false npm start停止该脚本记录的本地进程:
.\scripts\stop-local.ps1真实账号与部署
真实模式必须先用微信扫码完成 ClawBot 授权登录,并主动设置:
TRANSPORT_MODE=real
TRANSPORT_ACCOUNT_ID=<authorized-account-id>
TRANSPORT_POLLING_ENABLED=true不要提交 runtime/、.env、二维码、账号文件或任何 token。Linux systemd、HTTPS tunnel 和插件模板见 docs/DEPLOYMENT.md。ChatGPT 自动化规则见 docs/AUTOMATION.md,常见错误的分层判断见 docs/TROUBLESHOOTING.md,重试身份、运维通知分流和换窗经验见 docs/RELIABILITY_PLAYBOOK.md。
重要语义
新订阅只接收订阅建立之后的新事件;创建订阅不会自动 replay 已有 pending。
串行确认机制只管理启用该机制后新收到的事件,不会自动重放旧 pending。
pending 仅表示 transport 尚未记录成功回复,不代表 ChatGPT 会自动收到该事件。
在官方文档列明支持 MCP Events 的 Work / Work Desktop Cloud / dot 中,订阅建在哪个 ChatGPT 窗口,事件就在那个窗口里处理,并延续那个窗口的上下文;我们的做法是直接在原来聊天的窗口里建订阅。普通 Chat 见上方“适用范围”。
send_wechat_reply成功与用户手机端实际看到消息是两个不同证据层级。
License
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI clients to your Dactic work context through a hosted MCP service.
Link a WhatsApp number by QR code and use it from Claude or ChatGPT via MCP.
WhatsMCP connects Claude and other MCP-compatible AI agents directly to WhatsApp. Send and receive text, images, documents, and voice notes; manage groups (create, add/remove members, promote admins); look up contacts and profiles; follow channels; and read call and message history — all through a standard MCP interface. For voice use cases, WhatsMCP offers SIP-based calling plans (inbound-only, or full inbound/outbound) so AI voice agents can answer and place WhatsApp calls, plus low-latency WebSocket integrations with voice agent providers like ElevenLabs. Multiple WhatsApp accounts can be paired and managed per workspace, with webhook support for real-time inbound message delivery to your own infrastructure.
Connect any AI agent to 1,000+ apps and 27,000+ actions through one remote MCP server (OAuth).
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables to operate a WeChat Official Account via MCP tools, including searching and executing API workflows and uploading files.MIT
- AlicenseAqualityFmaintenanceEnables AI agents to publish articles to WeChat Official Account (微信公众号). Supports image upload, draft creation, and publishing via standardized MCP protocol.51ISC
- FlicenseAqualityDmaintenanceEnables AI agents to control WeChat through MCP protocol, including sending messages, managing contacts, and searching messages.10-
- FlicenseAqualityCmaintenanceEnables MCP clients like WorkBuddy to connect to the WeChat Official Account API, supporting connection checks, article bundle validation, image uploads, and draft creation and querying, while leaving publishing to the author.42-