WeChat DevTools MCP
Drive WeChat DevTools with plain English โ debug mini-programs & mini-games via AI.
๐จ๐ณ ไธญๆ ยท ๐บ๐ธ English
---
Just talk to your AI in natural language. It connects, finds errors, and verifies by screenshot โ for you:
> ๐ฃ๏ธ "Open my mini-program โ go to home โ tap login โ screenshot it"
>
> ๐ฎ "Open the mini-game โ tap cell (2,10) โ screenshot โ export logs"
Works with WorkBuddy, Claude Code, Cursor, Cline, Zed, and any MCP client.
---
## ๐ Get started in 3 steps
**1. Install**
```bash
npx -y wechat-dev-mcp
```
**2. Plug into your client** (same command, only the config file location differs)
Cursor example โ edit `~/.cursor/mcp.json`:
```json
{
"mcpServers": {
"wechat-devtools": {
"command": "npx",
"args": ["-y", "wechat-dev-mcp"]
}
}
}
```
> A ready-to-use `.cursor/mcp.json` / `.mcp.json` ships in the repo, or grab [`examples/cursor-mcp-config.json`](examples/cursor-mcp-config.json). Other clients (Claude Code / Desktop, Codex, Windsurf, Cline, Zed) use the same command.
**3. Just talk to your AI**
> "Open `/Users/you/project`, go to home, tap login, then screenshot it for me"
That's it.
---
## โ
Prerequisites (one-time)
- **WeChat DevTools** installed, with **Service Port** enabled: `Settings โ Security โ Service Port`
- **Node.js โฅ 18**
> โ ๏ธ Without the Service Port you'll get `Connection refused`.
---
## ๐งฉ Companion Skill (optional, recommended)
[wechat-dev-skill](https://github.com/jiawei686/wechat-dev-skill) wraps the "scan build / devtools / output / networks for errors" routine into one sentence. Install it, then just say "debug this project" and it locates errors for you.
---
## ๐ What it does (highlights)
- ๐ธ **Screenshot**: live capture of mini-program pages / mini-game canvas
- ๐ผ **Canvas export**: `export_canvas` dumps the **real content** of a page `