Watertian/Wechat-DevTools-MCP 是从 https://github.com/watertian/wechat-devtools-mcp. 导入的 MCP 服务器候选
概览
Watertian/Wechat-DevTools-MCP 是从 https://github.com/watertian/wechat-devtools-mcp. 导入的 MCP 服务器候选
概述（AI 翻译）
把微信开发者工具封装为 MCP 服务，让编辑器里的 AI 直接完成小程序的编译、预览、调试、自动化测试闭环。Windows / macOS，已上架官方 MCP Registry。
[!重要] 「瘦 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（一句话跑完巡检 / 异常排查 / 跨页面校验） | 本项目 技能 |
| 存量 1.06.x（NW.js） | 本项目继续兼容;官方内建 MCP 仅 2.x 有 |
⚠ 官方 IDE 把自家 bridge 注册为
wechat-devtools。本文示例统一用wechat-devtools-mcp避免撞名;旧名配置仍可用，只在同一 agent 同时接入两者时才需区分。
🚀 快速开始
步骤1 — 安装 MCP 服务器
[!警告] 曾用
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。
步骤2 — 开启开发者工具服务端口
开发者工具 → 设置 → 安全设置 → 服务端口 → 开启。不开则所有操作报 CLI_TIMEOUT。
本页由 AI 翻译，技术细节请以原文为准。
README
以下为原文 README 节选，完整内容请查看原文。
微信开发者工具 MCP Server (v0.9.20)
把微信开发者工具封装为 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 个已废弃）。两者互补，不是替代：
| 场景 | 用谁 |
|---|---|
| 打开项目 / 编译 / 预览 / 上传 / 点击输入 / 云开发 | 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 同时接入两者时才需区分。
🚀 快速开始
前置条件：Python ≥ 3.10（uv 会自动准备）、Node.js ≥ 18（daemon 依赖 puppeteer-core / jimp）、微信开发者工具 2.x 或 1.06.x。
Step 1 — 安装 MCP Server
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。
Step 2 — 开启开发者工具服务端口
开发者工具 → 设置 → 安全设置 → 服务端口 → 开启。不开则 open / compile / preview 等走 CLI 的操作全部报 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//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",安装
uvx wechat-devtools-mcp配置
{
"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"
}
}
}
}