Weapp Agent MCP
Agent-first MCP server for WeChat Mini Program debugging & automation via WeChat DevTools.
- Pricing
- Open source
- Runs
- Locally
- Version
- 0.4.8
- Listing updated
- 5 days ago
About Weapp Agent MCP
Weapp Agent MCP is an open-source MCP server. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add weapp-agent-mcp --env WEAPP_AUTO_ACCOUNT='<WEAPP_AUTO_ACCOUNT>' --env WEAPP_DEVTOOLS_TICKET='<WEAPP_DEVTOOLS_TICKET>' -- npx -y @chaixueyuan/weapp-agent-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"weapp-agent-mcp": {
"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
{
"mcpServers": {
"weapp-agent-mcp": {
"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
{
"servers": {
"weapp-agent-mcp": {
"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 ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"weapp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@chaixueyuan/weapp-agent-mcp"
],
"env": {
"WEAPP_AUTO_ACCOUNT": "<WEAPP_AUTO_ACCOUNT>",
"WEAPP_DEVTOOLS_TICKET": "<WEAPP_DEVTOOLS_TICKET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"weapp-agent-mcp": {
"command": "npx",
"args": [
"-y",
"@chaixueyuan/weapp-agent-mcp"
],
"env": {
"WEAPP_AUTO_ACCOUNT": "<WEAPP_AUTO_ACCOUNT>",
"WEAPP_DEVTOOLS_TICKET": "<WEAPP_DEVTOOLS_TICKET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WEAPP_WS_ENDPOINTAutomation 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_MODEForce 'launch' or 'connect' mode. Defaults to 'launch' unless WEAPP_WS_ENDPOINT is set.WEAPP_PROJECT_PATHOptional 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_PATHOptional override for the WeChat DevTools CLI binary path (e.g. /Applications/wechatwebdevtools.app/Contents/MacOS/cli on macOS).WEAPP_DEVTOOLS_PORTAutomation websocket port passed to 'cli auto --auto-port' in launch mode (default 9420).WEAPP_DEVTOOLS_TIMEOUTMilliseconds passed to miniprogram-automator when launching WeChat DevTools.WEAPP_AUTO_ACCOUNTOptional account passed to miniprogram-automator launch.WEAPP_DEVTOOLS_TICKETOptional DevTools launch ticket.WEAPP_TRUST_PROJECTWhether launch mode should trust the project. Accepts true/false, 1/0, yes/no, or on/off.WEAPP_DEVTOOLS_ARGSAdditional whitespace-separated CLI arguments passed during launch.WEAPP_DEVTOOLS_CWDOptional working directory passed to the DevTools launch process.WEAPP_AUTOCLOSEWhether to close or disconnect the automator session after each tool call. Accepts true/false, 1/0, yes/no, or on/off.WEAPP_AUTOLAUNCHAllow 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_TIMEOUTMilliseconds to wait for a locally auto-launched automation port (default 45000).WEAPP_CONNECT_TIMEOUTMilliseconds to wait for an automator websocket connection (default 45000).
Pricing
Open source
Weapp Agent MCP FAQ
Is Weapp Agent MCP free?
Yes. Weapp Agent MCP is open source, so you can use and self-host it for free.
How do I add Weapp Agent MCP to Claude Code?
Run this command in your terminal: claude mcp add weapp-agent-mcp --env WEAPP_AUTO_ACCOUNT='<WEAPP_AUTO_ACCOUNT>' --env WEAPP_DEVTOOLS_TICKET='<WEAPP_DEVTOOLS_TICKET>' -- npx -y @chaixueyuan/weapp-agent-mcp
Where this comes from
- Description: from the official MCP Registry entry.
- Install steps: from the official MCP Registry entry.