Weapp Agent MCP Server

by chaixueyuanio.github.Chaixueyuan/weapp-agent-mcpv0.4.8

Agent-first MCP server for WeChat Mini Program debugging, automation, and lightweight testing

18Node.jsstdioofficial registry

context tax

queued

security

queued

cold start

queued

freshness

Slowing3mo ago

Install Weapp Agent MCP server

claude mcp add weapp-agent -e WEAPP_AUTO_ACCOUNT='<weapp-auto-account>' -e WEAPP_DEVTOOLS_TICKET='<weapp-devtools-ticket>' -- npx -y @chaixueyuan/weapp-agent-mcp

{
  "mcpServers": {
    "weapp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_AUTO_ACCOUNT": "<weapp-auto-account>",
        "WEAPP_DEVTOOLS_TICKET": "<weapp-devtools-ticket>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (global) or .cursor/mcp.json (project).

{
  "mcpServers": {
    "weapp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_AUTO_ACCOUNT": "<weapp-auto-account>",
        "WEAPP_DEVTOOLS_TICKET": "<weapp-devtools-ticket>"
      }
    }
  }
}

Settings → Developer → Edit Config (claude_desktop_config.json), then restart.

{
  "servers": {
    "weapp-agent": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_AUTO_ACCOUNT": "<weapp-auto-account>",
        "WEAPP_DEVTOOLS_TICKET": "<weapp-devtools-ticket>"
      }
    }
  }
}

Add to .vscode/mcp.json in your workspace.

{
  "mcpServers": {
    "weapp-agent": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_AUTO_ACCOUNT": "<weapp-auto-account>",
        "WEAPP_DEVTOOLS_TICKET": "<weapp-devtools-ticket>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json.

Configuration

Variable	Required	Secret	Description
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	—	yes	Optional account passed to miniprogram-automator launch.
WEAPP_DEVTOOLS_TICKET	—	yes	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).

Freshness

Slowing — last maintenance signal 3mo ago. The newest of the signals below sets the band.

Last commit (default branch)
2026-07-01 · 3mo ago · GitHub
Latest release
2026-07-01 · 3mo ago · GitHub · v0.4.8
Package published
no data · npm/PyPI
Registry entry updated
2026-07-01 · 3mo ago · official registry · v0.4.8

FAQ

›How do I install the Weapp Agent MCP server in Claude Code?

Run: claude mcp add weapp-agent -e WEAPP_AUTO_ACCOUNT='<weapp-auto-account>' -e WEAPP_DEVTOOLS_TICKET='<weapp-devtools-ticket>' -- npx -y @chaixueyuan/weapp-agent-mcp. For Cursor, VS Code, Claude Desktop and Windsurf, use the install tabs above.

›Does Weapp Agent require an API key?

Yes. It expects WEAPP_AUTO_ACCOUNT, WEAPP_DEVTOOLS_TICKET, of which 2 are secrets.

›Can I use Weapp Agent as a remote (hosted) MCP server?

No hosted endpoint is published; it runs locally over stdio.

›Is Weapp Agent in the official MCP registry?

Yes, as io.github.Chaixueyuan/weapp-agent-mcp.