weapp-agent-mcp

weapp-agent-mcp is a local MCP server: Agent-first MCP server for WeChat Mini Program debugging & automation via WeChat DevTools. Install it from npm as @chaixueyuan/weapp-agent-mcp.

Claude CodeCodexAntigravity

commandprompt

Terminal

claude mcp add weapp-agent-mcp -e WEAPP_WS_ENDPOINT=... -e WEAPP_AUTOMATOR_MODE=... -e WEAPP_PROJECT_PATH=... -e WECHAT_DEVTOOLS_CLI_PATH=... -e WEAPP_DEVTOOLS_PORT=... -e WEAPP_DEVTOOLS_TIMEOUT=... -e WEAPP_AUTO_ACCOUNT=... -e WEAPP_DEVTOOLS_TICKET=... -e WEAPP_TRUST_PROJECT=... -e WEAPP_DEVTOOLS_ARGS=... -e WEAPP_DEVTOOLS_CWD=... -e WEAPP_AUTOCLOSE=... -e WEAPP_AUTOLAUNCH=... -e WEAPP_LAUNCH_TIMEOUT=... -e WEAPP_CONNECT_TIMEOUT=... -- npx -y @chaixueyuan/weapp-agent-mcp

Run in your project folder. Add --scope user to use it everywhere.

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "...",
        "WEAPP_AUTOMATOR_MODE": "...",
        "WEAPP_PROJECT_PATH": "...",
        "WECHAT_DEVTOOLS_CLI_PATH": "...",
        "WEAPP_DEVTOOLS_PORT": "...",
        "WEAPP_DEVTOOLS_TIMEOUT": "...",
        "WEAPP_AUTO_ACCOUNT": "...",
        "WEAPP_DEVTOOLS_TICKET": "...",
        "WEAPP_TRUST_PROJECT": "...",
        "WEAPP_DEVTOOLS_ARGS": "...",
        "WEAPP_DEVTOOLS_CWD": "...",
        "WEAPP_AUTOCLOSE": "...",
        "WEAPP_AUTOLAUNCH": "...",
        "WEAPP_LAUNCH_TIMEOUT": "...",
        "WEAPP_CONNECT_TIMEOUT": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

• Runtime: Node.js 18+ (runs with npx).
• MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
• Environment variables: WEAPP_WS_ENDPOINT, WEAPP_AUTOMATOR_MODE, WEAPP_PROJECT_PATH, WECHAT_DEVTOOLS_CLI_PATH, WEAPP_DEVTOOLS_PORT, WEAPP_DEVTOOLS_TIMEOUT, WEAPP_AUTO_ACCOUNT, WEAPP_DEVTOOLS_TICKET, WEAPP_TRUST_PROJECT, WEAPP_DEVTOOLS_ARGS, WEAPP_DEVTOOLS_CWD, WEAPP_AUTOCLOSE, WEAPP_AUTOLAUNCH, WEAPP_LAUNCH_TIMEOUT, WEAPP_CONNECT_TIMEOUT