接入你的智能体
發布者自己的指令。不是 PlugMCP 端點。
用我們的金鑰與日誌託管一份副本。
uvx wechat-devtools-mcp==0.9.21Claude Code 沒有本機指令的安裝連結。複製下方指令並在終端機中執行。
WECHAT_DEVTOOLS_CLI=<value> WECHAT_PROJECT_PATH=<value> WECHAT_CLI_TIMEOUT=<value> NODE_PATH=<value> WECHAT_CDP_PORT=<value> WECHAT_AUTOMATOR_READY_TIMEOUT=<value> claude mcp add watertian-wechat-devtools-mcp -- uvx wechat-devtools-mcp==0.9.21在終端機中執行。
{ "mcpServers": { "watertian-wechat-devtools-mcp": { "command": "uvx", "args": [ "wechat-devtools-mcp==0.9.21" ], "env": { "WECHAT_DEVTOOLS_CLI": "<value>", "WECHAT_PROJECT_PATH": "<value>", "WECHAT_CLI_TIMEOUT": "<value>", "NODE_PATH": "<value>", "WECHAT_CDP_PORT": "<value>", "WECHAT_AUTOMATOR_READY_TIMEOUT": "<value>" } } }}claude_desktop_config.json
遠端 URL 還是本機指令? 兩種安裝方式的差異
把微信开发者工具封装为 MCP 服务,让编辑器里的 AI 直接完成小程序的编译、预览、调试、自动化测试闭环。Windows / macOS,已上架官方 MCP Registry。
[!IMPORTANT] 「瘦 MCP + 胖 Skill」:MCP Server 只提供 7 个聚合工具,操作流程与最佳实践都在配套的 wechat-devtools Skill 里。两者必须一起装。
微信开发者工具 2.x 自 2026-08-18 起为官方 Stable(1.06 已下架),IDE 内建 MCP Server(47 个原子工具,其中 2 个已废弃)。两者互补,不是替代:
⚠ 官方 IDE 把自家 bridge 注册为
wechat-devtools。本文示例统一用wechat-devtools-mcp避免撞名;旧名配置仍可用,只在同一 agent 同时接入两者时才需区分。
前置条件:Python ≥ 3.10(uv 会自动准备)、Node.js ≥ 18(daemon 依赖 puppeteer-core / jimp)、微信开发者工具 2.x 或 1.06.x。
pip install uv # 或 brew install uv;已装可跳过
uv tool install wechat-devtools-mcp # 首次安装
uv tool install wechat-devtools-mcp --force --refresh # 升级:--refresh 刷新索引缓存,否则可能装回旧版
wechat-devtools-mcp --version # 确认实际运行版本
[!WARNING] 曾用
pip install装过旧版的,先pip uninstall wechat-devtools-mcp,否则旧路径优先于 uv。 ≤0.9.10 与 mcp SDK ≥2.0 不兼容(报ModuleNotFoundError: mcp.server.fastmcp),请升到 ≥0.9.11。
升级前先停掉编辑器里正在跑的 MCP 进程(重启编辑器即可)。用 uvx 配置的客户端会复用已缓存的环境、不会自动升级:跑一次 uvx --refresh wechat-devtools-mcp --version 刷新,或在 args 里锁定版本 wechat-devtools-mcp==X.Y.Z。
开发者工具 → 设置 → 安全设置 → 服务端口 → 开启。不开则 open / compile / preview 等走 CLI 的操作全部报 CLI_TIMEOUT。
JSON 里 Windows 路径的 \ 要写成 \\;macOS 的 / 不用转义。
标准配置(Claude Desktop / Antigravity / Kiro / Trae / Claude Code .mcp.json 通用):
{
"mcpServers": {
"wechat-devtools-mcp": {
"command": "uvx",
"args": ["wechat-devtools-mcp"],
"env": {
"WECHAT_DEVTOOLS_CLI": "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat",
"WECHAT_PROJECT_PATH": "D:\\Your\\Project\\Path"
}
}
}
}
9222 常年被 Chrome 等占用的机器,在 env 里再加一行 "WECHAT_CDP_PORT": "9333"。
[mcp_servers.wechat-devtools-mcp]
command = "uvx"
args = ["wechat-devtools-mcp"]
[mcp_servers.wechat-devtools-mcp.env]
WECHAT_DEVTOOLS_CLI = "C:\\Program Files (x86)\\Tencent\\微信web开发者工具\\cli.bat"
WECHAT_PROJECT_PATH = "D:\\Your\\Project\\Path"
npx -y skills add WaterTian/wechat-devtools-mcp/.agents/skills/wechat-devtools
不走 npx skills 的客户端(如 Trae):把仓库的 .agents/skills/wechat-devtools/ 整个复制到小程序项目的 .agents/skills/ 下即可。Skill 含 9 条 SOP、7 工具全 action 速查、CDP 渐进排查策略与故障手册,详见 SKILL.md。
在编辑器里调一次 wechat_ide(action='status'),下面几项都符合再开工:
动作遇到 automator 连接失败会自动 start 一次并重试(返回 auto_recovered);open 成功后 cdp_port 在同一会话内自动沿用,其它工具不必再传。完整参数见 MCP_DOC.md。云函数与云数据库请用 CloudBase MCP。
完整逐版本说明见 CHANGELOG.md。
MCP server + Skill for WeChat DevTools — lets the AI in your editor compile, preview, debug and auto-test Mini Programs. Windows / macOS, on the official MCP Registry. 微信开发者工具 MCP & Skills
{ "mcpServers": { "watertian-wechat-devtools-mcp": { "command": "uvx", "args": [ "wechat-devtools-mcp==0.9.21" ], "env": { "WECHAT_DEVTOOLS_CLI": "<value>", "WECHAT_PROJECT_PATH": "<value>", "WECHAT_CLI_TIMEOUT": "<value>", "NODE_PATH": "<value>", "WECHAT_CDP_PORT": "<value>", "WECHAT_AUTOMATOR_READY_TIMEOUT": "<value>" } } }}工具
尚無工具清單。遠端伺服器會在首次健康檢查後取得工具清單。
常見問題
在本頁複製適用於 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 設定。它使用發布者的安裝方式,而不是 PlugMCP 代理伺服器。
發布者列出了以下環境變數:WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT。
Wechat Devtools 透過 stdio 在本機執行。
上次檢查時間:2026-11-10。 MCP server + Skill for WeChat DevTools — lets the AI in your editor compile, preview, debug and auto-test Mini Programs. Windows / macOS, on the official MCP Registry. 微信开发者工具 MCP & Skills