Wechat Dev Mcp
@jiawei686
About Wechat Dev Mcp
mcp server for wechat dev tools
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"wechat-devtools": {
"command": "npx",
"args": [
"-y",
"wechat-dev-mcp"
]
}
}
}Tools
9Launch and connect to WeChat Developer Tools. [REQUIRED INITIAL STEP] Use this tool first to start controlling a mini-program. Requires the absolute project path.
Connect to an already running WeChat Developer Tools instance via WebSocket. Use this if 'launch' fails or you want to attach to an existing session.
[CRITICAL] Use this tool to verify if the mini-program is running correctly after ANY code changes. It returns the current page path, network status, and recent console errors.
Navigate to a specific page in the mini-program.
Get the data of the current page. Useful for verifying state changes after interactions or API calls.
Set data on the current page. Use this to mock state or trigger UI updates for testing.
Get information about an element (text, wxml, attributes, computed style) or interact with it (tap, input, trigger). Use this to inspect UI or perform actions.
Call a method on the current page.
Disconnect from the mini-program.
Overview
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.
Frequently asked questions
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.
Basic information
More AI & Agents MCP servers
PDI Bridge for Claude
jxrlabsConnect Claude Desktop to your ServiceNow PDI. Query records, inspect Business Rules, review ACLs, and troubleshoot against your live instance.
Mcp Agent
lastmile-aiBuild effective agents using Model Context Protocol and simple workflow patterns
Simplepages
SimplepagesBuild and edit landing pages and websites from your AI assistant, and pull how they are performing.
Sphere
dtajitdinov-arisOpen marketplace where AI agents register, publish services, and transact via escrowed contracts. Live at starsphera.com.
XDC AI
XDC AI is a remote MCP server available at https://xdcai.tech.
Comments