How do I install Wechat Devtools?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Wechat Devtools need an API key?

The publisher lists these environment variables: WECHAT_DEVTOOLS_CLI, WECHAT_PROJECT_PATH, WECHAT_CLI_TIMEOUT, NODE_PATH, WECHAT_CDP_PORT, WECHAT_AUTOMATOR_READY_TIMEOUT.

What transport does Wechat Devtools use?

Wechat Devtools runs locally over stdio.

When was Wechat Devtools last checked?

Last checked 2026-11-09. MCP Server for WeChat DevTools CLI - Automate development & testing with 7 aggregated APIs.

Wechat Devtools MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

uvx wechat-devtools-mcp==0.9.21

Credentials from the publisher

WECHAT_DEVTOOLS_CLI — 微信开发者工具 CLI 路径。Windows: C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat；macOS: /Applications/wechatwebdevtools.app/Contents/MacOS/cli
WECHAT_PROJECT_PATH — 默认小程序项目绝对路径，例如 D:\Projects\MyMiniApp
WECHAT_CLI_TIMEOUT — CLI 命令超时时间（秒）
NODE_PATH — Node.js 可执行文件路径
WECHAT_CDP_PORT — CDP 调试端口默认值；9222 被 Chrome 占用时设为 9333
WECHAT_AUTOMATOR_READY_TIMEOUT — automator start 等待首次应答的秒数

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1WECHAT_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 io.github.watertian-wechat-devtools-mcp -- uvx wechat-devtools-mcp==0.9.21

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.watertian-wechat-devtools-mcp": {4      "command": "uvx",5      "args": [6        "wechat-devtools-mcp==0.9.21"7      ],8      "env": {9        "WECHAT_DEVTOOLS_CLI": "<value>",10        "WECHAT_PROJECT_PATH": "<value>",11        "WECHAT_CLI_TIMEOUT": "<value>",12        "NODE_PATH": "<value>",13        "WECHAT_CDP_PORT": "<value>",14        "WECHAT_AUTOMATOR_READY_TIMEOUT": "<value>"15      }16    }17  }18}

claude_desktop_config.json

Local · pypiPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

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.

Launch

Server facts

Local

Transport: stdio
Version

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

微信开发者工具 MCP Server (v0.9.18)

把微信开发者工具封装为 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.x 优先官方内建 MCP（`wechat_ide(action='status')` 的 `official_mcp.available` 为 `true` 即可用）
长图拼接截图（固定头尾识别，拍不全如实上报）	本项目。官方只截视口并压到长边 1280 JPEG
CDP 结构化日志（回放采集前的历史、按页面归类、去噪）	本项目。官方只读缓存
任务级 SOP（一句话跑完巡检 / 异常排查 / 跨页面校验）	本项目 Skill
存量 1.06.x（NW.js）	本项目继续兼容；官方内建 MCP 仅 2.x 有

⚠ 官方 IDE 把自家 bridge 注册为 wechat-devtools。本文示例统一用 wechat-devtools-mcp 避免撞名；旧名配置仍可用，只在同一 agent 同时接入两者时才需区分。

🚀 快速开始

Step 1 — 安装 MCP Server

pip install uv                                  # 如已装可跳过
uv tool install wechat-devtools-mcp --force
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 进程，再 uv tool upgrade wechat-devtools-mcp。

Step 2 — 开启开发者工具服务端口

开发者工具 → 设置 → 安全设置 → 服务端口 → 开启。不开则所有操作报 CLI_TIMEOUT。

Step 3 — 准备两个绝对路径

路径	Windows	macOS
开发者工具 CLI	`C:\Program Files (x86)\Tencent\微信web开发者工具\cli.bat`	`/Applications/wechatwebdevtools.app/Contents/MacOS/cli`
小程序项目根目录	`D:\MyProjects\mini-app`	`/Users/<you>/Projects/mini-app`

JSON 里 Windows 路径的 \ 要写成 \\；macOS 的 / 不用转义。

Step 4 — 编辑器配置

标准配置（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"
      }
    }
  }
}

编辑器	配置位置	差异
Claude Desktop / Antigravity	`claude_desktop_config.json` / `mcp_config.json`	无
Claude Code（项目级）	仓库根目录 `.mcp.json`	macOS 下 `command` 用绝对路径 `/opt/homebrew/bin/uvx`，并在 `env` 加 `"PATH": "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin"` 与 `"NODE_PATH": "/opt/homebrew/bin/node"`（GUI 子进程不带 Homebrew PATH）
Kiro	`~/.kiro/settings/mcp.json`	可加 `"autoApprove": ["wechat_ide","wechat_build","wechat_automator","wechat_inspector","wechat_screenshot","wechat_navigate","wechat_file"]`
Trae ≥1.3	AI 面板 → 设置 → MCP → 手动配置；或 `%APPDATA%\Trae\User\globalStorage\mcp.json` / `~/Library/Application Support/Trae/User/globalStorage/mcp.json`	聊天须选 Builder with MCP 智能体；macOS 同 Claude Code 的绝对路径写法
Cursor / VS Code	MCP 面板新增 server	Name `wechat-devtools-mcp`，Command `uvx wechat-devtools-mcp`，环境变量同上
OpenAI Codex	`~/.codex/config.toml`	TOML，见下

[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"

Step 5 — 安装 Skill（必须）

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。

🛠️ 工具箱

工具	用途	action / 关键参数
`wechat_ide`	IDE 生命周期与环境诊断	`open` `login` `is_login` `close` `quit` `status`
`wechat_build`	构建与发布	`compile` `preview` `upload` `build_npm` `cache_clean`
`wechat_automator`	自动化交互与运行时查询	`start` `tap` `input` `element_info` `set_data` `call_method` `call_wx` `mock_wx` `evaluate` `page_stack` `page_data` `system_info` `storage`
`wechat_inspector`	运行时日志采集	`console` `cdp`
`wechat_screenshot`	长图拼接截图	`full_page` `page_path` `scroll_top`
`wechat_navigate`	跳转并采集 CDP 日志	`page_path`
`wechat_file`	项目文件读取	`project_info` `list_pages` `read_page` `read_file`

完整参数见 MCP_DOC.md。云函数与云数据库请用 CloudBase MCP。

💡 环境变量

变量	说明	默认
`WECHAT_DEVTOOLS_CLI`	开发者工具 CLI 路径（必填）	—
`WECHAT_PROJECT_PATH`	默认项目根目录（必填）	—
`WECHAT_CLI_TIMEOUT`	CLI 超时秒数	`30`
`NODE_PATH`	Node.js 可执行文件	`node`

❓ 常见问题

症状	处理
一直报 `CLI_TIMEOUT`	服务端口没开，见 Step 2；`wechat_ide(action='status')` 的 `service_port_enabled` 可自查
CDP 采集失败 / 采到的全是 Chrome	9222 被占用。`open(cdp_port=9223)`，且 `inspector` / `navigate` / `build` 用同一个 `cdp_port`
Windows 中文乱码或 `UnicodeDecodeError`	`env` 加 `"PYTHONIOENCODING": "utf-8"`
装了新版仍跑旧版	`pip uninstall wechat-devtools-mcp`，再用 `wechat-devtools-mcp --version` 确认
IDE 2.x 下工具行为异常	注册名与官方 `wechat-devtools` 撞车，改用 `wechat-devtools-mcp`

📋 版本历史

版本	日期	摘要
0.9.18	2026-09-04	Windows 2.x 真机闭环：状态目录 `User Data` 层、就绪判据、`quit` 等退出、噪音过滤；新增真机冒烟脚本
0.9.17	2026-09-03	适配开发者工具 2.x Stable；evaluate 新增 `fn_source`；`open` 提速约 4 倍；Windows 1.x/2.x 双轨判定
0.9.16	2026-08-27	长页面截图全面修复；源码开源
0.9.15	2026-08-20	适配开发者工具 2.x（Electron）；修复 CDP 采集自 0.9.0 起恒为 0 条
0.9.14	2026-08-20	`wechat_file` 路径口径统一；`cdp_port` 透传修复
0.9.13	2026-08-18	`--version` 早退；文档核对修复

完整逐版本说明见 CHANGELOG.md。

参考

微信开发者工具 CLI · 小程序自动化 SDK
许可证：MIT

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Wechat Devtools?

Does Wechat Devtools need an API key?

What transport does Wechat Devtools use?

When was Wechat Devtools last checked?

Documentation

微信开发者工具 MCP Server (v0.9.18)

🤝 与官方能力的关系

🚀 快速开始

Step 1 — 安装 MCP Server

Step 2 — 开启开发者工具服务端口

Step 3 — 准备两个绝对路径

Step 4 — 编辑器配置

Step 5 — 安装 Skill（必须）

🛠️ 工具箱

💡 环境变量

❓ 常见问题

📋 版本历史

参考