WeChat Mini Program MCP Server

Model Context Protocol (MCP) server for WeChat Mini Program automation using the official miniprogram-automator SDK.

---

Features

• LLM-Friendly: 65 AI-optimized tools for natural language automation
• Complete Coverage: Automator, MiniProgram, Page, Element, Assert, Snapshot, Record, Network tools
• Robust Runtime: Built-in timeout protection and retry mechanism for all async operations
• Zero Config: Auto-detects project path from project.config.json or app.json
• npx Ready: No installation needed, just npx -y @creatoria/miniapp-mcp
• Test Automation: Built-in assertion and recording capabilities
• TypeScript: Full type definitions with comprehensive test coverage

Quick Start

Installation

Use with npx (recommended):

npx -y @creatoria/miniapp-mcp

Or install globally:

npm install -g @creatoria/miniapp-mcp

Configuration

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "miniprogram": {
      "command": "npx",
      "args": ["-y", "@creatoria/miniapp-mcp"]
    }
  }
}

That’s it! The server will automatically detect your mini program project.

How It Works

The server wraps WeChat’s official miniprogram-automator SDK, exposing it through the Model Context Protocol. This allows AI assistants like Claude to:

1. Connect to WeChat DevTools automation interface
2. Control mini program UI through natural language
3. Verify behavior with built-in assertions
4. Debug with snapshots and recordings

Auto-Detection

The server automatically searches for mini program projects:

• Current directory (checks for project.config.json or app.json)