Skip to content
Back to search

miniapp-cdp-mcp

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

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/zhizhuodemao--miniapp-cdp-mcp/badge.svg)](/listings/zhizhuodemao--miniapp-cdp-mcp)

HTML

<a href="/listings/zhizhuodemao--miniapp-cdp-mcp"><img src="/api/listings/zhizhuodemao--miniapp-cdp-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 189 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. # MiniApp CDP MCP
  2. [English](https://github.com/zhizhuodemao/miniapp-cdp-mcp/blob/main/README_en.md) | 中文
  3. 微信小程序逆向工程 MCP 服务器,让你的 AI 编码助手(如 Claude、Cursor、Antigravity)能够直接通过 Chrome DevTools Protocol (CDP) 调试和分析微信小程序(包括微信开发者工具或 PC 端微信小程序)中的 JavaScript 代码。
  4. ## 功能特点
  5. - **多目标调试**: 支持在 `AppService`(逻辑层)和 `WebView`(渲染层)目标之间无缝切换
  6. - **网络拦截**: 捕获、监控和过滤由小程序发起的 XHR/Fetch 请求
  7. - **断点调试**: 设置/移除代码断点和 XHR 断点,支持在压缩混淆代码中精确定位
  8. - **执行控制**: 暂停/恢复执行,单步调试(over/into/out)并返回源码上下文
  9. - **脚本分析**: 列出所有加载的 JS 脚本,搜索代码,获取/保存源码
  10. - **运行时检查**: 在断点处求值表达式,检查调用栈和作用域变量
  11. - **WebSocket 分析**: 监控 WebSocket 连接和消息模式
  12. ## 系统要求
  13. - [Python](https://www.python.org/) 3.11 或更新版本
  14. - [uv](https://docs.astral.sh/uv/) (必需,超快的 Python 包和环境管理器)
  15. - 运行中的微信开发者工具(需开启调试端口)或 PC 版微信小程序(开启远程调试机制)
  16. ## 前置准备 1:开启小程序调试端口
  17. 在使用本 MCP 之前,你需要先通过注入工具将微信小程序的 CDP 调试端口暴露出来。你可以根据你的操作系统和微信版本,选择以下开源工具之一来完成 Hook 和端口暴露(通常暴露于 `62000` 端口):
  18. - [WMPFDebugger-arm](https://github.com/chain00x/WMPFDebugger-arm) (适用于 macOS ARM 架构)
  19. - [WMPFDebugger](https://github.com/evi0s/WMPFDebugger)
  20. - [WeChatOpenDevTools-Python](https://github.com/JaveleyQAQ/WeChatOpenDevTools-Python)
  21. ## 前置准备 2:安装 uv
  22. 本项目通过 `uvx` 实现零配置的“开箱即用”。如果你还没安装 `uv`,请先根据你的系统执行以下命令安装:
  23. **macOS / Linux:**
  24. ```bash
  25. curl -LsSf https://astral.sh/uv/install.sh | sh
  26. ```
  27. **Windows:**
  28. ```powershell
  29. powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  30. ```
  31. ## 快速开始(uvx 零安装)
  32. 无需把代码克隆到本地,你可以直接利用 `uv` 的能力,在 AI 助手的 MCP 配置文件中添加:
  33. ```json
  34. {
  35. "mcpServers": {
  36. "miniapp-cdp": {
  37. "command": "uvx",
  38. "args": ["--from", "miniapp-cdp", "miniapp-cdp-mcp"]
  39. }
  40. }
  41. }
  42. ```
  43. ### Claude Desktop
  44. 修改 `~/Library/Application Support/Claude/claude_desktop_config.json`,加入上述配置。
  45. ### Cursor
  46. 进入 `Cursor Settings` -> `Features` -> `MCP` -> `Add new MCP server`:
  47. - **Type**: `command`
  48. - **Name**: `miniapp-cdp`
  49. - **Command**: `uvx --from miniapp-cdp miniapp-cdp-mcp`
  50. ## 本地安装(可选)
  51. 如果你想在本地修改或开发:
  52. ```bash
  53. git clone https://github.com/yourusername/miniapp-cdp-py.git
  54. cd miniapp-cdp-py
  55. uv sync
  56. ```
  57. 然后在 MCP 配置中使用本地运行方式:
  58. ```json
  59. {
  60. "mcpServers": {
  61. "miniapp-cdp": {
  62. "command": "uv",
  63. "args": ["run", "run_mcp_server.py"],
  64. "cwd": "/你的路径/miniapp-cdp-py"
  65. }
  66. }
  67. }
  68. ```
  69. ## 工具列表
  70. ### 目标与上下文管理
  71. | 工具 | 描述 |
  72. | ----------------- | ---------------------------------------- |
  73. | `list_targets` | 列出调试器中所有可用的目标(AppService 线程、WebView 线程等) |
  74. | `switch_target` | 切换 CDP 连接到不同的目标线程进行调试上下文切换 |
  75. ### 网络与 WebSocket
  76. | 工具 | 描述 |
  77. | ------------------------ | ---------------------------------------------- |
  78. | `list_network_requests` | 列出小程序网络请求(支持分页),或获取单条详情 |
  79. | `get_request_initiator` | 获取发起网络请求的 JavaScript 调用栈 |
  80. | `get_response_body` | 获取网络请求的完整响应体 |
  81. | `get_websocket_messages` | 列出 WebSocket 连接或获取特定连接的消息详情 |
  82. ### 脚本分析
  83. | 工具 | 描述 |
  84. | -------------------- | ---------------------------------------------------- |
  85. | `list_scripts` | 列出当前页面加载的所有 JavaScript 脚本 |
  86. | `get_script_source` | 获取脚本源码片段,支持行范围或字符偏移 |
  87. | `save_script_source` | 保存完整脚本源码到本地文件(适用于提取整包或核心风控代码) |
  88. | `search_in_sources` | 在所有脚本中搜索字符串或正则表达式 |
  89. ### 断点与执行控制
  90. | 工具 | 描述 |
  91. | ------------------------ | ---------------------------------------------- |
  92. | `set_breakpoint_on_text` | 通过搜索代码文本自动设置断点(切勿直接对匿名函数声明下断点) |
  93. | `break_on_xhr` | 按 URL 模式设置 XHR/Fetch 断点 |
  94. | `remove_breakpoints` | 移除指定的断点,或通过 `clear_all=True` 瞬间清空所有断点环境 |
  95. | `list_breakpoints` | 列出所有活动断点 |
  96. | `get_paused_info` | 获取暂停状态、调用栈和作用域变量 |
  97. | `resume_execution` | 释放断点,恢复代码执行 |
  98. | `step` | 单步调试(over/into/out),返回位置和源码上下文 |
  99. ### 检查工具
  100. | 工具 | 描述 |
  101. | ----------------------- | ---------------------------------------------- |
  102. | `evaluate_script` | 在当前上下文中执行 JavaScript 表达式(支持在断点暂停时执行) |
  103. ## 使用示例
  104. ### 小程序逆向工程基本流程
  105. 1. **连接与目标切换**
  106. ```
  107. 列出所有小程序目标,并切换到 AppService (逻辑层) 线程
  108. ```
  109. 2. **查找目标函数与代码**
  110. ```
  111. 在所有脚本中搜索包含 "encrypt" 的代码,并获取相关脚本的上下文源码
  112. ```
  113. 3. **设置断点**
  114. ```
  115. 在加密函数的具体执行语句(如 return 处)设置断点
  116. ```
  117. 4. **触发并分析**
  118. ```
  119. 在小程序上点击触发网络请求,断点命中后,检查参数、调用栈以及密钥的生成逻辑
  120. ```
  121. ### 拦截并分析网络请求
  122. ```
  123. 抓取最新发出的网络请求列表,并找出特定的加密请求(如带有 mina_edata 参数的请求),
  124. 随后获取该请求的发起者调用栈 (Initiator) 定位加密入口。
  125. ```
  126. ## 实战案例
  127. 在项目的 `examples/` 目录下,包含了一些利用本工具逆向得出的实战脚本(例如 `vipshop_decrypt_demo.py`),展示了如何通过 MCP 分析出小程序的复杂多层加密算法并在 Python 中完美还原。
  128. ## 安全提示
  129. 此工具会将小程序的底层运行上下文暴露给 MCP 客户端,允许检查、调试和修改应用内存中的任何数据。请勿将此工具用于非法用途,仅限于个人学习、安全研究与合法授权的逆向分析。
  130. ## 致谢
  131. 本项目构建在 [cdp-use](https://github.com/browser-use/cdp-use) 之上。`cdp-use` 提供了一个面向 Agent 场景进行高度优化和抽象的底层 WebSocket 交互层,极大地简化了原始 CDP 协议的通信复杂性。
  132. ## 许可证
  133. MIT License

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.