PluginBench
MCP Server
Active
MIT

io.github.Chaixueyuan/weapp-agent-mcp MCP Server

io.github.Chaixueyuan/weapp-agent-mcp

What is the io.github.Chaixueyuan/weapp-agent-mcp MCP server?

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

How to install io.github.Chaixueyuan/weapp-agent-mcp

Copy-paste configuration for popular MCP clients.

transport: stdio
Config generated by PluginBench — verify against the source before use.
Environment / auth
  • 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).

Claude Desktop
~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "<YOUR_WEAPP_WS_ENDPOINT>",
        "WEAPP_AUTOMATOR_MODE": "<YOUR_WEAPP_AUTOMATOR_MODE>",
        "WEAPP_PROJECT_PATH": "<YOUR_WEAPP_PROJECT_PATH>",
        "WECHAT_DEVTOOLS_CLI_PATH": "<YOUR_WECHAT_DEVTOOLS_CLI_PATH>",
        "WEAPP_DEVTOOLS_PORT": "<YOUR_WEAPP_DEVTOOLS_PORT>",
        "WEAPP_DEVTOOLS_TIMEOUT": "<YOUR_WEAPP_DEVTOOLS_TIMEOUT>",
        "WEAPP_AUTO_ACCOUNT": "<YOUR_WEAPP_AUTO_ACCOUNT>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_WEAPP_DEVTOOLS_TICKET>",
        "WEAPP_TRUST_PROJECT": "<YOUR_WEAPP_TRUST_PROJECT>",
        "WEAPP_DEVTOOLS_ARGS": "<YOUR_WEAPP_DEVTOOLS_ARGS>",
        "WEAPP_DEVTOOLS_CWD": "<YOUR_WEAPP_DEVTOOLS_CWD>",
        "WEAPP_AUTOCLOSE": "<YOUR_WEAPP_AUTOCLOSE>",
        "WEAPP_AUTOLAUNCH": "<YOUR_WEAPP_AUTOLAUNCH>",
        "WEAPP_LAUNCH_TIMEOUT": "<YOUR_WEAPP_LAUNCH_TIMEOUT>",
        "WEAPP_CONNECT_TIMEOUT": "<YOUR_WEAPP_CONNECT_TIMEOUT>"
      }
    }
  }
}
Cursor
~/.cursor/mcp.json
{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "<YOUR_WEAPP_WS_ENDPOINT>",
        "WEAPP_AUTOMATOR_MODE": "<YOUR_WEAPP_AUTOMATOR_MODE>",
        "WEAPP_PROJECT_PATH": "<YOUR_WEAPP_PROJECT_PATH>",
        "WECHAT_DEVTOOLS_CLI_PATH": "<YOUR_WECHAT_DEVTOOLS_CLI_PATH>",
        "WEAPP_DEVTOOLS_PORT": "<YOUR_WEAPP_DEVTOOLS_PORT>",
        "WEAPP_DEVTOOLS_TIMEOUT": "<YOUR_WEAPP_DEVTOOLS_TIMEOUT>",
        "WEAPP_AUTO_ACCOUNT": "<YOUR_WEAPP_AUTO_ACCOUNT>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_WEAPP_DEVTOOLS_TICKET>",
        "WEAPP_TRUST_PROJECT": "<YOUR_WEAPP_TRUST_PROJECT>",
        "WEAPP_DEVTOOLS_ARGS": "<YOUR_WEAPP_DEVTOOLS_ARGS>",
        "WEAPP_DEVTOOLS_CWD": "<YOUR_WEAPP_DEVTOOLS_CWD>",
        "WEAPP_AUTOCLOSE": "<YOUR_WEAPP_AUTOCLOSE>",
        "WEAPP_AUTOLAUNCH": "<YOUR_WEAPP_AUTOLAUNCH>",
        "WEAPP_LAUNCH_TIMEOUT": "<YOUR_WEAPP_LAUNCH_TIMEOUT>",
        "WEAPP_CONNECT_TIMEOUT": "<YOUR_WEAPP_CONNECT_TIMEOUT>"
      }
    }
  }
}
Windsurf
~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "weapp-agent-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "<YOUR_WEAPP_WS_ENDPOINT>",
        "WEAPP_AUTOMATOR_MODE": "<YOUR_WEAPP_AUTOMATOR_MODE>",
        "WEAPP_PROJECT_PATH": "<YOUR_WEAPP_PROJECT_PATH>",
        "WECHAT_DEVTOOLS_CLI_PATH": "<YOUR_WECHAT_DEVTOOLS_CLI_PATH>",
        "WEAPP_DEVTOOLS_PORT": "<YOUR_WEAPP_DEVTOOLS_PORT>",
        "WEAPP_DEVTOOLS_TIMEOUT": "<YOUR_WEAPP_DEVTOOLS_TIMEOUT>",
        "WEAPP_AUTO_ACCOUNT": "<YOUR_WEAPP_AUTO_ACCOUNT>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_WEAPP_DEVTOOLS_TICKET>",
        "WEAPP_TRUST_PROJECT": "<YOUR_WEAPP_TRUST_PROJECT>",
        "WEAPP_DEVTOOLS_ARGS": "<YOUR_WEAPP_DEVTOOLS_ARGS>",
        "WEAPP_DEVTOOLS_CWD": "<YOUR_WEAPP_DEVTOOLS_CWD>",
        "WEAPP_AUTOCLOSE": "<YOUR_WEAPP_AUTOCLOSE>",
        "WEAPP_AUTOLAUNCH": "<YOUR_WEAPP_AUTOLAUNCH>",
        "WEAPP_LAUNCH_TIMEOUT": "<YOUR_WEAPP_LAUNCH_TIMEOUT>",
        "WEAPP_CONNECT_TIMEOUT": "<YOUR_WEAPP_CONNECT_TIMEOUT>"
      }
    }
  }
}
VS Code
.vscode/mcp.json
{
  "servers": {
    "weapp-agent-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chaixueyuan/weapp-agent-mcp"
      ],
      "env": {
        "WEAPP_WS_ENDPOINT": "<YOUR_WEAPP_WS_ENDPOINT>",
        "WEAPP_AUTOMATOR_MODE": "<YOUR_WEAPP_AUTOMATOR_MODE>",
        "WEAPP_PROJECT_PATH": "<YOUR_WEAPP_PROJECT_PATH>",
        "WECHAT_DEVTOOLS_CLI_PATH": "<YOUR_WECHAT_DEVTOOLS_CLI_PATH>",
        "WEAPP_DEVTOOLS_PORT": "<YOUR_WEAPP_DEVTOOLS_PORT>",
        "WEAPP_DEVTOOLS_TIMEOUT": "<YOUR_WEAPP_DEVTOOLS_TIMEOUT>",
        "WEAPP_AUTO_ACCOUNT": "<YOUR_WEAPP_AUTO_ACCOUNT>",
        "WEAPP_DEVTOOLS_TICKET": "<YOUR_WEAPP_DEVTOOLS_TICKET>",
        "WEAPP_TRUST_PROJECT": "<YOUR_WEAPP_TRUST_PROJECT>",
        "WEAPP_DEVTOOLS_ARGS": "<YOUR_WEAPP_DEVTOOLS_ARGS>",
        "WEAPP_DEVTOOLS_CWD": "<YOUR_WEAPP_DEVTOOLS_CWD>",
        "WEAPP_AUTOCLOSE": "<YOUR_WEAPP_AUTOCLOSE>",
        "WEAPP_AUTOLAUNCH": "<YOUR_WEAPP_AUTOLAUNCH>",
        "WEAPP_LAUNCH_TIMEOUT": "<YOUR_WEAPP_LAUNCH_TIMEOUT>",
        "WEAPP_CONNECT_TIMEOUT": "<YOUR_WEAPP_CONNECT_TIMEOUT>"
      }
    }
  }
}
Claude Code
claude mcp add weapp-agent-mcp --env WEAPP_WS_ENDPOINT=<YOUR_WEAPP_WS_ENDPOINT> --env WEAPP_AUTOMATOR_MODE=<YOUR_WEAPP_AUTOMATOR_MODE> --env WEAPP_PROJECT_PATH=<YOUR_WEAPP_PROJECT_PATH> --env WECHAT_DEVTOOLS_CLI_PATH=<YOUR_WECHAT_DEVTOOLS_CLI_PATH> --env WEAPP_DEVTOOLS_PORT=<YOUR_WEAPP_DEVTOOLS_PORT> --env WEAPP_DEVTOOLS_TIMEOUT=<YOUR_WEAPP_DEVTOOLS_TIMEOUT> --env WEAPP_AUTO_ACCOUNT=<YOUR_WEAPP_AUTO_ACCOUNT> --env WEAPP_DEVTOOLS_TICKET=<YOUR_WEAPP_DEVTOOLS_TICKET> --env WEAPP_TRUST_PROJECT=<YOUR_WEAPP_TRUST_PROJECT> --env WEAPP_DEVTOOLS_ARGS=<YOUR_WEAPP_DEVTOOLS_ARGS> --env WEAPP_DEVTOOLS_CWD=<YOUR_WEAPP_DEVTOOLS_CWD> --env WEAPP_AUTOCLOSE=<YOUR_WEAPP_AUTOCLOSE> --env WEAPP_AUTOLAUNCH=<YOUR_WEAPP_AUTOLAUNCH> --env WEAPP_LAUNCH_TIMEOUT=<YOUR_WEAPP_LAUNCH_TIMEOUT> --env WEAPP_CONNECT_TIMEOUT=<YOUR_WEAPP_CONNECT_TIMEOUT> -- npx -y @chaixueyuan/weapp-agent-mcp

Related MCP servers

Give your AI agent stealth web scraping with Cloudflare bypass and CSS selection, powered by Scrapling.

67k
Python
BSD-3-Clause
View repository →

Give your AI coding agent full control of a live Chrome browser for automation, debugging, and performance analysis.

45k
TypeScript
Apache-2.0
View repository →

Let AI agents manage your Puter files, websites, and serverless workers over MCP.

43k
TypeScript
AGPL-3.0
View repository →

Browser automation for AI agents via MCP, powering ByteDance's Agent TARS hybrid GUI/DOM browser control.

37k
TypeScript
Apache-2.0
View repository →

Run arbitrary shell commands from an MCP-connected AI agent.

37k
TypeScript
Apache-2.0
View repository →

Filesystem access MCP server from ByteDance's UI-TARS/Agent TARS ecosystem.

37k
TypeScript
Apache-2.0
View repository →