Home › Other › weapp-agent-mcp

weapp-agent-mcp

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

TypeScript
★ 16 stars Last pushed 2026-07-01 License: MIT

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/weapp-agent-mcp@0.4.8

Or add to your MCP client config:

{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp@0.4.8"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "<YOUR_VALUE>",
        "WEAPP_AUTOMATOR_MODE": "<YOUR_VALUE>",
        "WEAPP_PROJECT_PATH": "<YOUR_VALUE>",
        "WECHAT_DEVTOOLS_CLI_PATH": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_PORT": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_TIMEOUT": "<YOUR_VALUE>",
        "WEAPP_AUTO_ACCOUNT": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_VALUE>",
        "WEAPP_TRUST_PROJECT": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_ARGS": "<YOUR_VALUE>",
        "WEAPP_DEVTOOLS_CWD": "<YOUR_VALUE>",
        "WEAPP_AUTOCLOSE": "<YOUR_VALUE>",
        "WEAPP_AUTOLAUNCH": "<YOUR_VALUE>",
        "WEAPP_LAUNCH_TIMEOUT": "<YOUR_VALUE>",
        "WEAPP_CONNECT_TIMEOUT": "<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).

Related servers

Data from the Official MCP Registry