Английский | 中文

微信小程序逆向工程 MCP 服务器,让你的 AI 编码助手(如 Claude、Cursor、Antigravity)能够直接通过 Chrome DevTools Protocol (CDP) 调试和分析微信小程序(包括微信开发者工具或 PC 端微信小程序)中的 JavaScript 代码。

功能特点

• 多目标调试: 支持在 AppService（逻辑层）和 WebView（渲染层）目标之间无缝切换
• 网络拦截: 捕获、监控和过滤由小程序发起的 XHR/Fetch 请求
• 断点调试: 设置/移除代码断点和 XHR 断点,支持在压缩混淆代码中精确定位
• 执行控制: 暂停/恢复执行,单步调试(over/into/out)并返回源码上下文
• 脚本分析: 列出所有加载的 JS 脚本，搜索代码，获取/保存源码
• 运行时检查: 在断点处求值表达式，检查调用栈和作用域变量
• WebSocket 分析: 监控 WebSocket 连接和消息模式

系统要求

• Python 3.11 或更新版本
• UV (必需,超快的 Python 包和环境管理器)
• 运行中的微信开发者工具（需开启调试端口）或 PC 版微信小程序（开启远程调试机制）

前置准备 1：开启小程序调试端口

在使用本 MCP 之前,你需要先通过注入工具将微信小程序的 CDP 调试端口暴露出来。 你可以根据你的操作系统和微信版本,选择以下开源工具之一来完成 Hook 和端口暴露(通常暴露于 62000 端口):

• WMPFDebugger-arm (适用于 macOS ARM 架构)
• WMPFDebugger
• WeChatOpenDevTools-Python

前置准备 2:安装 uv

本项目通过 uvx 实现零配置的“开箱即用”。 如果你还没安装 uv，请先根据你的系统执行以下命令安装：

macOS / Linux:

Windows:

快速开始(uvx 零安装)

无需把代码克隆到本地,你可以直接利用 uv 的能力,在 AI 助手的 MCP 配置文件中添加:

Клод Десктоп

修改 ~/Library/Application Support/Claude/claude_desktop_config.json,加入上述配置。

Курсор

进入 Cursor Settings -> Features -> MCP -> Add new MCP server:

• Тип: command
• Имя: miniapp-cdp

MiniApp CDP MCP

English | 中文

微信小程序逆向工程 MCP 服务器，让你的 AI 编码助手（如 Claude、Cursor、Antigravity）能够直接通过 Chrome DevTools Protocol (CDP) 调试和分析微信小程序（包括微信开发者工具或 PC 端微信小程序）中的 JavaScript 代码。

功能特点

• 多目标调试: 支持在 AppService（逻辑层）和 WebView（渲染层）目标之间无缝切换
• 网络拦截: 捕获、监控和过滤由小程序发起的 XHR/Fetch 请求
• 断点调试: 设置/移除代码断点和 XHR 断点，支持在压缩混淆代码中精确定位
• 执行控制: 暂停/恢复执行，单步调试（over/into/out）并返回源码上下文
• 脚本分析: 列出所有加载的 JS 脚本，搜索代码，获取/保存源码
• 运行时检查: 在断点处求值表达式，检查调用栈和作用域变量
• WebSocket 分析: 监控 WebSocket 连接和消息模式

系统要求

• Python 3.11 或更新版本
• uv (必需，超快的 Python 包和环境管理器)
• 运行中的微信开发者工具（需开启调试端口）或 PC 版微信小程序（开启远程调试机制）

前置准备 1：开启小程序调试端口

在使用本 MCP 之前，你需要先通过注入工具将微信小程序的 CDP 调试端口暴露出来。你可以根据你的操作系统和微信版本，选择以下开源工具之一来完成 Hook 和端口暴露（通常暴露于 62000 端口）：

• WMPFDebugger-arm (适用于 macOS ARM 架构)
• WMPFDebugger
• WeChatOpenDevTools-Python

前置准备 2：安装 uv

本项目通过 uvx 实现零配置的“开箱即用”。如果你还没安装 uv，请先根据你的系统执行以下命令安装：

macOS / Linux:

curl -LsSf https://astral.sh/uv/install.sh | sh

Windows:

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

快速开始（uvx 零安装）

无需把代码克隆到本地，你可以直接利用 uv 的能力，在 AI 助手的 MCP 配置文件中添加：

{
  "mcpServers": {
    "miniapp-cdp": {
      "command": "uvx",
      "args": ["--from", "miniapp-cdp", "miniapp-cdp-mcp"]
    }
  }
}

Claude Desktop

修改 ~/Library/Application Support/Claude/claude_desktop_config.json，加入上述配置。

Cursor

进入 Cursor Settings -> Features -> MCP -> Add new MCP server：

• Type: command
• Name: miniapp-cdp
• Command: uvx --from miniapp-cdp miniapp-cdp-mcp

本地安装（可选）

如果你想在本地修改或开发：

git clone https://github.com/yourusername/miniapp-cdp-py.git
cd miniapp-cdp-py
uv sync

然后在 MCP 配置中使用本地运行方式：

{
  "mcpServers": {
    "miniapp-cdp": {
      "command": "uv",
      "args": ["run", "run_mcp_server.py"],
      "cwd": "/你的路径/miniapp-cdp-py"
    }
  }
}

工具列表

目标与上下文管理

网络与 WebSocket

脚本分析

| 工具 | 描述 |