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

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

• 运行时：Node.js 20.17+
• 协议： MCP（模型上下文协议） ·存储： SQLite ·语言： TypeScript

---

快速开始

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

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

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

---

工具

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

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

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

---

微信公众号 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         # 静态检查与测试