Agent-first MCP server for WeChat Mini Program debugging & automation via WeChat DevTools.
Connect Runs on your machine
claude mcp add weapp-agent-mcp -e WEAPP_WS_ENDPOINT=<WEAPP_WS_ENDPOINT> -e WEAPP_AUTOMATOR_MODE=<WEAPP_AUTOMATOR_MODE> -e WEAPP_PROJECT_PATH=<WEAPP_PROJECT_PATH> -e WECHAT_DEVTOOLS_CLI_PATH=<WECHAT_DEVTOOLS_CLI_PATH> -e WEAPP_DEVTOOLS_PORT=<WEAPP_DEVTOOLS_PORT> -e WEAPP_DEVTOOLS_TIMEOUT=<WEAPP_DEVTOOLS_TIMEOUT> -e WEAPP_AUTO_ACCOUNT=<WEAPP_AUTO_ACCOUNT> -e WEAPP_DEVTOOLS_TICKET=<WEAPP_DEVTOOLS_TICKET> -e WEAPP_TRUST_PROJECT=<WEAPP_TRUST_PROJECT> -e WEAPP_DEVTOOLS_ARGS=<WEAPP_DEVTOOLS_ARGS> -e WEAPP_DEVTOOLS_CWD=<WEAPP_DEVTOOLS_CWD> -e WEAPP_AUTOCLOSE=<WEAPP_AUTOCLOSE> -e WEAPP_AUTOLAUNCH=<WEAPP_AUTOLAUNCH> -e WEAPP_LAUNCH_TIMEOUT=<WEAPP_LAUNCH_TIMEOUT> -e WEAPP_CONNECT_TIMEOUT=<WEAPP_CONNECT_TIMEOUT> -- npx -y @chaixueyuan/[email protected]{
"mcpServers": {
"weapp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@chaixueyuan/[email protected]"
],
"env": {
"WEAPP_WS_ENDPOINT": "<WEAPP_WS_ENDPOINT>",
"WEAPP_AUTOMATOR_MODE": "<WEAPP_AUTOMATOR_MODE>",
"WEAPP_PROJECT_PATH": "<WEAPP_PROJECT_PATH>",
"WECHAT_DEVTOOLS_CLI_PATH": "<WECHAT_DEVTOOLS_CLI_PATH>",
"WEAPP_DEVTOOLS_PORT": "<WEAPP_DEVTOOLS_PORT>",
"WEAPP_DEVTOOLS_TIMEOUT": "<WEAPP_DEVTOOLS_TIMEOUT>",
"WEAPP_AUTO_ACCOUNT": "<WEAPP_AUTO_ACCOUNT>",
"WEAPP_DEVTOOLS_TICKET": "<WEAPP_DEVTOOLS_TICKET>",
"WEAPP_TRUST_PROJECT": "<WEAPP_TRUST_PROJECT>",
"WEAPP_DEVTOOLS_ARGS": "<WEAPP_DEVTOOLS_ARGS>",
"WEAPP_DEVTOOLS_CWD": "<WEAPP_DEVTOOLS_CWD>",
"WEAPP_AUTOCLOSE": "<WEAPP_AUTOCLOSE>",
"WEAPP_AUTOLAUNCH": "<WEAPP_AUTOLAUNCH>",
"WEAPP_LAUNCH_TIMEOUT": "<WEAPP_LAUNCH_TIMEOUT>",
"WEAPP_CONNECT_TIMEOUT": "<WEAPP_CONNECT_TIMEOUT>"
}
}
}
}{
"mcpServers": {
"weapp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@chaixueyuan/[email protected]"
],
"env": {
"WEAPP_WS_ENDPOINT": "<WEAPP_WS_ENDPOINT>",
"WEAPP_AUTOMATOR_MODE": "<WEAPP_AUTOMATOR_MODE>",
"WEAPP_PROJECT_PATH": "<WEAPP_PROJECT_PATH>",
"WECHAT_DEVTOOLS_CLI_PATH": "<WECHAT_DEVTOOLS_CLI_PATH>",
"WEAPP_DEVTOOLS_PORT": "<WEAPP_DEVTOOLS_PORT>",
"WEAPP_DEVTOOLS_TIMEOUT": "<WEAPP_DEVTOOLS_TIMEOUT>",
"WEAPP_AUTO_ACCOUNT": "<WEAPP_AUTO_ACCOUNT>",
"WEAPP_DEVTOOLS_TICKET": "<WEAPP_DEVTOOLS_TICKET>",
"WEAPP_TRUST_PROJECT": "<WEAPP_TRUST_PROJECT>",
"WEAPP_DEVTOOLS_ARGS": "<WEAPP_DEVTOOLS_ARGS>",
"WEAPP_DEVTOOLS_CWD": "<WEAPP_DEVTOOLS_CWD>",
"WEAPP_AUTOCLOSE": "<WEAPP_AUTOCLOSE>",
"WEAPP_AUTOLAUNCH": "<WEAPP_AUTOLAUNCH>",
"WEAPP_LAUNCH_TIMEOUT": "<WEAPP_LAUNCH_TIMEOUT>",
"WEAPP_CONNECT_TIMEOUT": "<WEAPP_CONNECT_TIMEOUT>"
}
}
}
}{
"servers": {
"weapp-agent-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@chaixueyuan/[email protected]"
],
"env": {
"WEAPP_WS_ENDPOINT": "<WEAPP_WS_ENDPOINT>",
"WEAPP_AUTOMATOR_MODE": "<WEAPP_AUTOMATOR_MODE>",
"WEAPP_PROJECT_PATH": "<WEAPP_PROJECT_PATH>",
"WECHAT_DEVTOOLS_CLI_PATH": "<WECHAT_DEVTOOLS_CLI_PATH>",
"WEAPP_DEVTOOLS_PORT": "<WEAPP_DEVTOOLS_PORT>",
"WEAPP_DEVTOOLS_TIMEOUT": "<WEAPP_DEVTOOLS_TIMEOUT>",
"WEAPP_AUTO_ACCOUNT": "<WEAPP_AUTO_ACCOUNT>",
"WEAPP_DEVTOOLS_TICKET": "<WEAPP_DEVTOOLS_TICKET>",
"WEAPP_TRUST_PROJECT": "<WEAPP_TRUST_PROJECT>",
"WEAPP_DEVTOOLS_ARGS": "<WEAPP_DEVTOOLS_ARGS>",
"WEAPP_DEVTOOLS_CWD": "<WEAPP_DEVTOOLS_CWD>",
"WEAPP_AUTOCLOSE": "<WEAPP_AUTOCLOSE>",
"WEAPP_AUTOLAUNCH": "<WEAPP_AUTOLAUNCH>",
"WEAPP_LAUNCH_TIMEOUT": "<WEAPP_LAUNCH_TIMEOUT>",
"WEAPP_CONNECT_TIMEOUT": "<WEAPP_CONNECT_TIMEOUT>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
WEAPP_WS_ENDPOINTOptional | Automation WebSocket endpoint for the 'connect' flow (e.g. ws://localhost:9420). When a local endpoint is not listening and auto-launch is enabled, mp_ensureConnection may start DevTools if it can resolve a project. |
WEAPP_AUTOMATOR_MODEOptional | Force 'launch' or 'connect' mode. Defaults to 'launch' unless WEAPP_WS_ENDPOINT is set. |
WEAPP_PROJECT_PATHOptional | Optional Mini Program project directory used by launch and local auto-launch flows. The server can also resolve a persisted default, a recent project, or the current working directory. |
WECHAT_DEVTOOLS_CLI_PATHOptional | Optional override for the WeChat DevTools CLI binary path (e.g. /Applications/wechatwebdevtools.app/Contents/MacOS/cli on macOS). |
WEAPP_DEVTOOLS_PORTOptional | Automation websocket port passed to 'cli auto --auto-port' in launch mode (default 9420). |
WEAPP_DEVTOOLS_TIMEOUTOptional | Milliseconds passed to miniprogram-automator when launching WeChat DevTools. |
WEAPP_AUTO_ACCOUNTOptional, secret | Optional account passed to miniprogram-automator launch. |
WEAPP_DEVTOOLS_TICKETOptional, secret | Optional DevTools launch ticket. |
WEAPP_TRUST_PROJECTOptional | Whether launch mode should trust the project. Accepts true/false, 1/0, yes/no, or on/off. |
WEAPP_DEVTOOLS_ARGSOptional | Additional whitespace-separated CLI arguments passed during launch. |
WEAPP_DEVTOOLS_CWDOptional | Optional working directory passed to the DevTools launch process. |
WEAPP_AUTOCLOSEOptional | Whether to close or disconnect the automator session after each tool call. Accepts true/false, 1/0, yes/no, or on/off. |
WEAPP_AUTOLAUNCHOptional | Allow mp_ensureConnection to launch local WeChat DevTools with cli auto when the configured local automation port is not listening. Defaults to enabled; set false to disable. |
WEAPP_LAUNCH_TIMEOUTOptional | Milliseconds to wait for a locally auto-launched automation port (default 45000). |
WEAPP_CONNECT_TIMEOUTOptional | Milliseconds to wait for an automator websocket connection (default 45000). |
Details
| Package | @chaixueyuan/[email protected] (NPM, stdio) |
| First published | 1 Jul 2026 |
| Last updated | 1 Jul 2026 |
| Registry name | io.github.Chaixueyuan/weapp-agent-mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.