Potencialize seu agente
O comando do próprio publicador. Não é um endpoint do PlugMCP.
Host a copy with our keys and logs.
uvx wechat-devtools-mcp==0.9.21O Claude Code não tem link de instalação para um comando local. Copie o comando abaixo e execute-o em um terminal.
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.21Execute em um terminal.
{ "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 remota ou um comando na sua máquina? Como as duas instalações diferem
Rodar no PlugMCP
A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.
Abrir把微信开发者工具封装为 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>" } } }}Ferramentas
Ainda não há lista de ferramentas. Servidores remotos recebem uma após a primeira verificação de saúde.
Perguntas frequentes
Copie nesta página a configuração stdio para Cursor, Claude Desktop, Claude Code ou VS Code. Ela usa a instalação do publicador, não um proxy do PlugMCP.
O publicador lista estas variáveis de ambiente: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT.
Wechat Devtools roda localmente via stdio.
Última verificação: 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