SOFT AI 伊豆用(Claude Desktop、Cursor ) MC信公 MC API 成的 MCP。

** מלונות ARY前版本**: v2.2.1 · 更新日星 · 南南

-** 구인정보**: Node.js 20.17+ -** MC**: MCP (모델 콘텍스트 프로토콜) ·**▶: SQLite · **

---

₢ 킹

中 Claude 데스크탑, claude_desktop_config.json 中:加:

[T2]] AppSecret,行行里。

会 [./data/wechat-mcp.db,中中app_secret] A A A( A生成于[T5]],T有 600)。

---

은

按 14 按,다「按分鶏」按:按,限。所有按 JSON을。

인포메이션 인포메이션 | お知らせ|【T6】|【T7】】|【T7】】 wechat_media_read] / [T9]] - /T、文文内图片 | wechat_audience_read] [T11]] [T11] | T | [T12] / [T13] | T | [T14] / wechat_messaging_write | [T16] - 、T、)(T) | | search_actions+[T18]]/[T19]|

一[T20]] 一体操作,::

、T、客服账号、账号配额、自动回复、,、,、,、,、,用search_actions] ID(TIC 101 个), ,用 execute_read_action / execute_write_action] 炉端串行行。行[T24]] 明该用法。

---

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