内容
# wmpf-reverse-mcp
[](https://www.python.org/)
[](LICENSE)
**微信小程序 CDP 调试 MCP 服务器**
通过 MCP（Model Context Protocol）为 AI 助手提供微信小程序的 CDP 调试能力。支持自动检测小程序连接、捕获加载的脚本、执行 JavaScript 表达式等。
---
## 功能
| 功能 | 说明 |
|------|------|
| **自动连接** | 自动检测小程序连接事件，无需手动操作 |
| **脚本捕获** | 自动捕获小程序加载的所有脚本 |
| **本地存储** | 脚本源码保存到本地文件，不占用 AI 上下文 |
| **JS 执行** | 在小程序上下文中执行任意 JavaScript |
| **自动启动** | 可自动启动 WMPFDebugger 子进程 |
| **前置检查** | 启动前自动检查端口占用、WeChat 进程状态 |
---
## 快速开始
### 前置条件
- **Python** ≥ 3.10
- **Node.js**（WMPFDebugger 依赖）
- **WMPFDebugger** 项目（[GitHub](https://github.com/evi0s/WMPFDebugger)）
- **微信桌面客户端**（WeChatAppEx.exe）
### 安装
```bash
# 克隆项目
git clone <your-repo>
cd wmpf-reverse-mcp
# 安装依赖
pip install -e .
```
### 启动
```bash
# 自动启动 WMPFDebugger（推荐）
wmpf-reverse --wmpf-dir /path/to/WMPFDebugger
# 或指定 conda 环境中的 python
python -m wmpf_reverse --wmpf-dir /path/to/WMPFDebugger
```
安装完成后，可以在 AI 助手的 MCP 配置中添加：
```json
{
"mcpServers": {
"wmpf-reverse": {
"command": "wmpf-reverse",
"args": ["--wmpf-dir", "/path/to/WMPFDebugger"]
}
}
}
```
### 使用示例
```
1. 启动 MCP 服务器
2. 冷启动微信小程序
3. AI 助手自动检测到连接，开始捕获脚本
4. 使用 get_captured_scripts() 查看已捕获脚本
5. 使用 get_script_source() 获取脚本源码
```
---
## 主要参数
```
--wmpf-dir, -d <路径> WMPFDebugger 目录（自动启动模式）
--log-file, -l <路径> 日志文件路径（经典模式）
--port, -p <端口> CDP 端口，默认 62000
--debug-port <端口> WMPFDebugger 调试端口，默认 9421
--no-auto-start 禁用自动启动
```
---
## 项目结构
```
src/wmpf_reverse/
├── mcp_server.py # MCP 服务器入口
├── cli.py # CLI 参数解析
├── adapters.py # 行源适配器
├── wmpf_debugger.py # WMPFDebugger 子进程管理
└── core/
├── config.py # 配置管理
├── cdp_client.py # CDP WebSocket 客户端
├── log_monitor.py # 日志事件监控
├── logger.py # 日志记录
├── mcp_tools.py # MCP 工具（7 个）
└── wmpf_service.py # 核心服务层
```
---
## 文档
详细使用指南见 [USAGE.md](USAGE.md)。
## 许可
[MIT](LICENSE)
