Home › Development › weapp-agent-mcp

weapp-agent-mcp

Agent-first MCP server for WeChat Mini Program debugging & automation via WeChat DevTools.

TypeScript

★ 24 stars Last pushed 2026-07-01 License: MIT

View repository →

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Package (npm 0.4.8)

npx -y @chaixueyuan/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/[email protected]"
      ],
      "env": {
        "WEAPP_AUTO_ACCOUNT": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_VALUE>"
      }
    }
  }
}

WEAPP_WS_ENDPOINT — 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_MODE — Force 'launch' or 'connect' mode. Defaults to 'launch' unless WEAPP_WS_ENDPOINT is set.
WEAPP_PROJECT_PATH — 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_PATH — Optional override for the WeChat DevTools CLI binary path (e.g. /Applications/wechatwebdevtools.app/Contents/MacOS/cli on macOS).
WEAPP_DEVTOOLS_PORT — Automation websocket port passed to 'cli auto --auto-port' in launch mode (default 9420).
WEAPP_DEVTOOLS_TIMEOUT — Milliseconds passed to miniprogram-automator when launching WeChat DevTools.
WEAPP_AUTO_ACCOUNT secret — Optional account passed to miniprogram-automator launch.
WEAPP_DEVTOOLS_TICKET secret — Optional DevTools launch ticket.
WEAPP_TRUST_PROJECT — Whether launch mode should trust the project. Accepts true/false, 1/0, yes/no, or on/off.
WEAPP_DEVTOOLS_ARGS — Additional whitespace-separated CLI arguments passed during launch.
WEAPP_DEVTOOLS_CWD — Optional working directory passed to the DevTools launch process.
WEAPP_AUTOCLOSE — Whether to close or disconnect the automator session after each tool call. Accepts true/false, 1/0, yes/no, or on/off.
WEAPP_AUTOLAUNCH — 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_TIMEOUT — Milliseconds to wait for a locally auto-launched automation port (default 45000).
WEAPP_CONNECT_TIMEOUT — Milliseconds to wait for an automator websocket connection (default 45000).