Wechat Devtools

This is a comprehensive MCP server for WeChat Mini Program development that wraps the official devtools CLI with automation capabilities. You get IDE lifecycle control, build and upload commands, and full Puppeteer-style automation through their internal protocol. The real value is the inspector tools that tap into Chrome DevTools Protocol on port 9222 to catch rendering errors and console logs that the CLI alone misses. Setup requires pointing it to your WeChat devtools installation and enabling the service port in settings. The docs are thorough with SOPs for common workflows like navigating pages, hot-reloading data during debugging, and running pre-release checks across all pages. Works best if you're already in the WeChat ecosystem and tired of manual clicking through the simulator.

skills.sh installs: 500
GitHub stars: 166
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add watertian/wechat-devtools-mcp --skill wechat-devtools --agent claude-code

Installs into .claude/skills of the current project.

Files

Wechat DevTools MCP Skill (v0.9.21)

前置条件

Step 0：安装与配置

pip install uv
uv tool install wechat-devtools-mcp            # 升级：uv tool install wechat-devtools-mcp --force --refresh

{
  "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"
      }
    }
  }
}

注册名用 wechat-devtools-mcp（开发者工具 2.x 把自家 MCP bridge 注册成 wechat-devtools，同名会被覆盖）。macOS CLI 路径 /Applications/wechatwebdevtools.app/Contents/MacOS/cli。各编辑器配置见 README。
必须开启服务端口：设置 → 安全设置 → 服务端口。未开启则所有 CLI 操作报 CLI_TIMEOUT。
9222 常被 Chrome 占用的机器在 env 加 "WECHAT_CDP_PORT": "9333"；Node.js 须 ≥ 18。