io.github.Chaixueyuan/weapp-agent-mcp

MCP

by Chaixueyuan · v0.4.7

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

mcplocal

MCP configuration

stdio

Command

npx -y @chaixueyuan/weapp-agent-mcp@0.4.7

Environment

  • 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_ACCOUNTsecret

    Optional account passed to miniprogram-automator launch.

  • WEAPP_DEVTOOLS_TICKETsecret

    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).

Install in one click with Zurek

Browse here, install from the native macOS app — pick targets, fill env vars, and write configs safely.