特定非営利活動法人(Claude Desktop、Cursor 等) 提供微信公称 API 集成的 MCP 服务。

前髪版本: [v2.2.1] · 更新志 · 投稿者棒南

• 行列時間:Node.js 20.17+
• ** 语**: MCP (Model Context Protocol) · ** 存続**: SQLite · **: TypeScript

お問い合わせ

始 始 始 始

接入クラウデデスクトップ,在 [claude_desktop_config.json]] 中野:

推 用 在 在 在 在 在 [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ 在 在 在 在 在 在 在 在 在 在 。 。 在 。 。 。 。 在 在 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。 。

[./data/wechat-mcp.db], [app_secret]]]], app_secret], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T5], [T4], [T4], [T4], [T4]], [T4], [T4]], [T4], [6], [6], [6], [6], [6], [6], [7], [7], [6], [7], [7], [7], [7], [7], [7], [7], [7], [7], [7], [7], [7], [7], [8], [8], [7], [7], [7], [7], [7]

お問い合わせ

工具

「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 「 所有 所有 所有 所有 端 端 端 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 所有 ジェイソン。

| 工具 | | お問い合わせ | |wechat_content_read / [wechat_content_write] — 草和布 | | 素材 | wechat_media_read / [wechat_media_write] - 素材・書籍・書籍・書籍 | wechat_audience_read / [wechat_audience_write] — 小麦粉、白名詞 | | wechat_engagement_read / [wechat_engagement_write] — 文脈 | | wechat_messaging_read / [wechat_messaging_write] — 模板・服・群集 | | 数の悩み | [wechat_statistics — — 表紙の内容、消息、接待について | | 長尾 | [[T17] + execute_read_action / [[T19] |

每个 一 一 一 一 一 [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ [ ] 例 [ [ 例 例 例 例 例 : : : 例 , , : : : :

共 尾 尾 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 先 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端 端

お問い合わせ

微信公众号 MCP 服务

为 AI 应用（Claude Desktop、Cursor 等）提供微信公众号 API 集成的 MCP 服务。

当前版本: v2.2.1 · 更新日志 · 开发者指南

• 运行时: Node.js 20.17+
• 协议: MCP (Model Context Protocol) · 存储: SQLite · 语言: TypeScript

---

快速开始

WECHAT_APP_ID= WECHAT_APP_SECRET= npx wechat-official-account-mcp mcp

接入 Claude Desktop，在 claude_desktop_config.json 中添加：

{
  "mcpServers": {
    "wechat-official-account": {
      "command": "npx",
      "args": ["wechat-official-account-mcp", "mcp"],
      "env": {
        "WECHAT_APP_ID": "",
        "WECHAT_APP_SECRET": ""
      }
    }
  }
}

推荐用环境变量而非 -a/-s 参数传 AppSecret，避免密钥出现在进程命令行里。

凭据会存入 ./data/wechat-mcp.db，其中 app_secret 等敏感字段默认 AES 加密（密钥未指定时自动生成于 ./data/.secret-key，权限 600）。

---

工具

对外暴露 14 个工具，按「读写分离」组织：只读与写入操作位于不同工具，便于客户端对写入操作做权限控制。所有工具返回 JSON。

每个域工具用一个 action 参数选择具体操作，例如：

wechat_content_read  { "action": "list", "count": 10 }     # 列出草稿
wechat_content_write { "action": "add", "articles": [...] } # 新建草稿
wechat_content_write { "action": "submit", "mediaId": "..." } # 提交发布

菜单、二维码、短链、客服账号、账号配额、自动回复、商品卡片、认证配置等长尾能力未单独建工具，先用 search_actions 检索动作 ID（共 101 个），再用 execute_read_action / execute_write_action 执行。服务端 instructions 已说明该用法。

---

配置

AppID / AppSecret 获取：微信公众平台 → 开发 → 基本配置。

---

远程部署（Streamable HTTP）

MCP_HTTP_TOKEN=$(openssl rand -hex 32) \
CORS_ORIGIN=https://your-client.example \
npx wechat-official-account-mcp mcp -m http -p 3000

⚠️ 微信 IP 白名单：公众号 API 要求调用方 IP 在账号后台白名单内，否则报 40164 invalid ip。 部署到服务器后，需把该服务器出口 IP 加入「公众号后台 → 开发 → 基本配置 → IP 白名单」。

--mode sse 保留但已废弃（该传输无鉴权且被 MCP 规范取代），建议改用 http。

也可以直接用 Docker：docker compose up -d（见 docker-compose.yml）。 systemd + nginx 常驻部署的配置与运维步骤与环境强相关，不入库，保存在本地 deploy/。

---

开发

npm install
npm run dev -- mcp -a  -s    # 开发模式
npm run check && npm run lint && npm test         # 静态检查与测试