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 - ๐ **Touch**: tap / long-press / swipe (mini-game cell taps auto-compensated for precise hits) - ๐ **Logs**: console / vConsole / network requests to locate errors - ๐ **Restart**: re-open & recompile safely (no crash-prone `Page.reload`) - ๐งช **Verify**: auto-connects the simulator, runs flows, checks the UI Full mini-game guide: [docs/MINIGAME_GUIDE.md](docs/MINIGAME_GUIDE.md) (Chinese). --- ## โ FAQ | Problem | Fix | |---------|-----| | `Connection refused` | DevTools running + Service Port enabled | | Mini-game tap does nothing | Get the game into an interactive screen first (e.g. "start game"), then ask AI to tap | | Tap lands off | Use `game_tap_grid` (compensated); re-calibrate if still off | | Game frozen | Ask AI to `restart_project`; **don't** use `Page.reload` | --- [MIT](LICENSE) ยฉ CuiJiawei ยท Issues & PRs welcome