Advertise
MCP.so
Sign In

Wechat Dev MCP Server

@jiawei686

Repository

Basic information

Category

AI & Agents

License

MIT

Transports

stdio

Author

jiawei686

Submitted by

Felix CUI

About Wechat Dev MCP Server

mcp server for wechat dev tools

#wechat#dev#miniprogram#minigame

Wechat Dev MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "wechat-devtools": {
      "command": "npx",
      "args": [
        "-y",
        "wechat-dev-mcp"
      ]
    }
  }
}

Wechat Dev MCP Server tools

9

Launch and connect to WeChat Developer Tools. [REQUIRED INITIAL STEP] Use this tool first to start controlling a mini-program. Requires the absolute project path.

Connect to an already running WeChat Developer Tools instance via WebSocket. Use this if 'launch' fails or you want to attach to an existing session.

[CRITICAL] Use this tool to verify if the mini-program is running correctly after ANY code changes. It returns the current page path, network status, and recent console errors.

Navigate to a specific page in the mini-program.

Get the data of the current page. Useful for verifying state changes after interactions or API calls.

Set data on the current page. Use this to mock state or trigger UI updates for testing.

Get information about an element (text, wxml, attributes, computed style) or interact with it (tap, input, trigger). Use this to inspect UI or perform actions.

Call a method on the current page.

Disconnect from the mini-program.

Overview

What is Wechat Dev Mcp?

It controls WeChat Developer Tools and mini‑programs/mini‑games via the Model Context Protocol (MCP). It works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible AI agent.

How to use Wechat Dev Mcp?

Install Node.js v18+ and enable the Service Port in WeChat DevTools (设置 → 安全设置 → 服务端口). Add the server configuration (using npx -y wechat-dev-mcp or a globally installed wechat-dev-mcp command) to your MCP client’s settings. Then use the provided tools to launch, connect, and automate DevTools.

Key features of Wechat Dev Mcp

  • 36 tools covering connection, navigation, and interaction
  • Automated launch and WebSocket connection to DevTools
  • Element interaction: tap, long-press, input text
  • Code execution: evaluate JavaScript and call wx.* APIs
  • Mini‑game specific tools (info, user info, cloud storage)
  • Debugging: console logs, screenshots, health checks

Use cases of Wechat Dev Mcp

  • Debug and test mini‑program pages (state, UI, navigation)
  • Automate repetitive DevTools operations (build npm, deploy cloud functions)
  • Interact with mini‑games: run scripts, call APIs, check logs
  • Integrate WeChat DevTools into CI/CD or AI‑assisted workflows
  • Verify code changes with health checks after each modification

Frequently asked questions

1

What prerequisites are needed?

Node.js v18+, WeChat DevTools installed with the Service Port enabled, and an open mini‑program or mini‑game project.

2

How do I connect to a running DevTools instance?

Use the `launch` tool (opens DevTools and a project) or the `connect` tool (connects via WebSocket, default `ws://localhost:9420`).

3

What should I do if I get a "Connection refused" error?

Ensure DevTools is running and the Service Port is enabled in the settings. Then retry the connection.

4

Can I use page tools (e.g., `get_element`) on a mini‑game?

No. Page tools return clear errors if used on a game project. Use `evaluate`, `call_wx_method`, or the `game_*` tools instead.

5

How can I verify everything works after making code changes?

Run the `check_health` tool. It checks connection, page path, network, console errors, and project type.

Comments

More AI & Agents MCP servers

CrawlForge MCP Server

mysleekdesigns

28-tool MCP server for web scraping, crawling, deep research & autonomous extraction — clean Markdown & structured JSON for Claude, Cursor & any MCP client. 1,000 free one-time credits, local-Ollama LLM support.

2

XDC AI

XDC AI is a remote MCP server available at https://xdcai.tech.

SlopIt: blogs for AI agents

SimbaStack

Blog MCP server for AI agents. One signup call returns a blog, an API key and a live URL; then your agent publishes markdown posts and gets public URLs back. Your agent does the writing; you get a dashboard for stats.

AON — Agent Offer Network

AON

AON MCP connects AI agents to real, buyable products and services with live pricing and tracked links—enabling builders to earn developer revenue share from attributed clicks and conversions.

2

Gemina

Gemina Tech Ltd.

Extract, search and tag any document — invoices, receipts, contracts, forms, or your own templates. 13 tools, one sign-in (OAuth 2.1) or API key, free FileTag tier, data residency in the EU, US, Israel or Asia.

Advertise