Wechat Dev Mcp

What is Wechat Dev Mcp?

It controls WeChat Developer Tools and mini‑programs/mini‑games via the Model Context Protocol (MCP). It works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI agent.

How to use Wechat Dev Mcp?

Install Node.js v18+ and enable the Service Port in WeChat DevTools (设置 → 安全设置 → 服务端口). Add the server configuration (using npx -y wechat-dev-mcp or a globally installed wechat-dev-mcp command) to your MCP client’s settings. Then use the provided tools to launch, connect, and automate DevTools.

Key features of Wechat Dev Mcp

• 36 tools covering connection, navigation, and interaction
• Automated launch and WebSocket connection to DevTools
• Element interaction: tap, long-press, input text
• Code execution: evaluate JavaScript and call wx.* APIs
• Mini‑game specific tools (info, user info, cloud storage)
• Debugging: console logs, screenshots, health checks

Use cases of Wechat Dev Mcp

• Debug and test mini‑program pages (state, UI, navigation)
• Automate repetitive DevTools operations (build npm, deploy cloud functions)
• Interact with mini‑games: run scripts, call APIs, check logs
• Integrate WeChat DevTools into CI/CD or AI‑assisted workflows
• Verify code changes with health checks after each modification

FAQ from Wechat Dev Mcp

What prerequisites are needed?

Node.js v18+, WeChat DevTools installed with the Service Port enabled, and an open mini‑program or mini‑game project.

How do I connect to a running DevTools instance?

Use the launch tool (opens DevTools and a project) or the connect tool (connects via WebSocket, default ws://localhost:9420).

What should I do if I get a "Connection refused" error?

Ensure DevTools is running and the Service Port is enabled in the settings. Then retry the connection.

Can I use page tools (e.g., get_element) on a mini‑game?

No. Page tools return clear errors if used on a game project. Use evaluate, call_wx_method, or the game_* tools instead.

How can I verify everything works after making code changes?

Run the check_health tool. It checks connection, page path, network, console errors, and project type.