Skip to content
Back to search

sunnymcptool

基于 SunnyNet 中间件和 SunnyNetTools 抓包工具扩展的 MCP Server

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/a121400--sunnymcptool/badge.svg)](/listings/a121400--sunnymcptool)

HTML

<a href="/listings/a121400--sunnymcptool"><img src="/api/listings/a121400--sunnymcptool/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 · 210 lines

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

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # SunnyNet MCP Server
  2. 基于 [SunnyNet](https://github.com/qtgolang/SunnyNet) 网络中间件的 MCP Server,让 AI 直接控制网络抓包、修改请求/响应、管理断点等。
  3. ![预览](img/mcp-preview.png)
  4. ## 下载
  5. 从 [Releases](https://github.com/a121400/sunnymcptool/releases) 下载:
  6. | 平台 | GUI 主程序 | MCP 桥接 |
  7. |------|-----------|----------|
  8. | Windows | `SunnyNet.exe` | `sunnynet-mcp.exe` |
  9. | macOS (Apple Silicon) | `SunnyNet.app` | `sunnynet-mcp` |
  10. ## 使用方法
  11. ### 1. 启动 GUI
  12. 运行 `SunnyNet.exe`(Windows)或 `SunnyNet.app`(macOS),GUI 启动后自动开启 MCP HTTP 端点(默认端口 29999)。
  13. ### 2. 配置 Cursor / Claude Desktop
  14. 在 `.cursor/mcp.json` 或对应配置文件中添加:
  15. ```json
  16. {
  17. "mcpServers": {
  18. "sunnynet": {
  19. "command": "/path/to/sunnynet-mcp",
  20. "args": ["-port", "29999"]
  21. }
  22. }
  23. }
  24. ```
  25. > `sunnynet-mcp` 是轻量级 stdio→HTTP 桥接程序,将 Cursor 的 JSON-RPC 请求转发到 GUI 的 MCP 端点。
  26. ### 3. 对话使用
  27. 在 Cursor 中直接:
  28. - "启动抓包"
  29. - "显示最近的请求"
  30. - "搜索包含 login 的请求"
  31. - "查看请求 123 的详情"
  32. - "添加断点拦截 api.example.com"
  33. - "修改响应体"
  34. ## 架构
  35. ```
  36. Cursor ──stdio──> sunnynet-mcp ──HTTP──> SunnyNet GUI (:29999/mcp)
  37. │
  38. 代理端口 (:2024)
  39. │
  40. 浏览器/手机/App 流量
  41. ```
  42. - **GUI 主程序**:Wails 桌面应用,包含完整 SunnyNet 引擎 + MCP HTTP Server + 可视化界面
  43. - **MCP 桥接**:纯 Go 程序(~8MB),处理 MCP 协议握手,转发工具调用到 GUI
  44. - **tshark 后端**:集成 Wireshark tshark 实现网卡级原始抓包和协议解析(需单独放置 `wireshark/` 目录)
  45. ## MCP 工具列表
  46. | 分类 | 工具 | 说明 |
  47. |------|------|------|
  48. | **代理控制** | `proxy_start` / `proxy_stop` | 启动/停止代理 |
  49. | | `proxy_set_port` | 设置代理端口 |
  50. | | `proxy_get_status` | 获取运行状态 |
  51. | | `proxy_set_ie` / `proxy_unset_ie` | 设置/取消系统代理 |
  52. | | `proxy_pause_capture` / `proxy_resume_capture` | 暂停/恢复捕获 |
  53. | **请求** | `request_list` | 获取请求列表(分页) |
  54. | | `request_get` | 获取请求详情 |
  55. | | `request_search` | 按 URL/方法/状态码搜索 |
  56. | | `request_body_search` | 在 Body 中搜索关键词 |
  57. | | `request_get_response_body_decoded` | 获取解码后的响应体 |
  58. | | `request_modify_header` / `request_modify_body` | 修改请求头/体 |
  59. | | `response_modify_header` / `response_modify_body` | 修改响应头/体 |
  60. | | `request_block` | 阻断请求 |
  61. | | `request_release_all` | 放行所有拦截的请求 |
  62. | | `request_resend` | 重发请求 |
  63. | | `request_stats` | 抓包统计 |
  64. | | `request_save_all` / `request_import` | 保存/导入抓包数据(.syn 格式) |
  65. | | `request_highlight_search` / `request_highlight_clear` | UI 高亮搜索 |
  66. | **长连接** | `connection_list` | 列出 WS/TCP/UDP 连接 |
  67. | | `socket_data_list` / `socket_data_get` / `socket_data_get_range` | 数据包操作 |
  68. | **断点** | `breakpoint_add` / `breakpoint_list` / `breakpoint_remove` / `breakpoint_clear` | 断点管理 |
  69. | **规则** | `replace_rules_add` / `replace_rules_list` / `replace_rules_remove` / `replace_rules_clear` | 替换规则。除全局 String/HEX/Base64、响应文件外,还可按请求头、响应头、请求体、响应体、正则、仅 URL 替换,并用 `url` 限制生效范围 |
  70. | | `hosts_list` / `hosts_add` / `hosts_remove` | HOSTS 规则 |
  71. | **进程** | `process_list` / `process_add_name` / `process_remove_name` | 进程过滤 |
  72. | **抓包(Wireshark)** | `capture_list_interfaces` | 列出网络接口(需 Npcap) |
  73. | | `capture_start` / `capture_stop` / `capture_status` | 原始网卡级抓包 |
  74. | | `capture_read_pcap` | 读取 pcap + Wireshark 显示过滤器 |
  75. | | `capture_packet_detail` | 单帧完整协议解析 |
  76. | | `capture_decode_tls` | TLS 密钥日志解密 HTTPS |
  77. | | `capture_statistics` | 协议层次/会话/端点统计 |
  78. | **证书** | `cert_install` / `cert_export` | CA 证书管理 |
  79. | **配置** | `config_get` | 获取全部配置 |
  80. ## 从源码编译
  81. **前置条件**:Go 1.23+、Node.js 18+、[Wails CLI](https://wails.io/docs/gettingstarted/installation)
  82. ```bash
  83. git clone https://github.com/a121400/sunnymcptool.git
  84. cd sunnymcptool
  85. # 安装 Wails CLI(如未安装)
  86. go install github.com/wailsapp/wails/v2/cmd/wails@latest
  87. # 编译(自动处理前端 + 后端)
  88. wails build
  89. # 编译 MCP 桥接(可选)
  90. cd headless && go build -o ../build/bin/sunnynet-mcp .
  91. ```
  92. 产物在 `build/bin/` 目录。macOS 用户可指定平台:`wails build -platform darwin/arm64`
  93. **Wireshark 抓包功能(可选):**
  94. capture_ 工具族需要 tshark 可执行文件。将编译好的 Wireshark 放到 `build/bin/wireshark/` 目录:
  95. - Windows: 需要 [Npcap](https://npcap.com/) 驱动才能实时抓包
  96. - 从 [Wireshark 源码](https://gitlab.com/wireshark/wireshark) 编译或下载官方安装包中的 tshark.exe
  97. ## 安卓云函数抓包 (Cloud安卓)
  98. 一键抓取安卓微信小程序的云函数 API 调用,无需配置代理证书。
  99. ### 原理
  100. 通过 Frida 动态注入 Hook 微信进程的 `AppBrandCommonBindingJni.nativeInvokeHandler` 和 `invokeCallbackHandler`,实时拦截所有云函数的请求和响应。
  101. ### 使用
  102. 1. 手机连接 USB,打开 USB 调试
  103. 2. 手机需要 ROOT 权限(Magisk / KernelSU)
  104. 3. 在 SunnyNet GUI 点击顶部 **"Cloud安卓"** 按钮
  105. 4. 程序自动检查环境(Node.js / ADB / Frida),缺失的组件会自动下载安装
  106. 5. 环境就绪后自动启动 Hook,成功后弹窗提示,开始捕获云函数调用
  107. ### 自动处理
  108. 点击 Cloud安卓 按钮后,程序会依次自动检查并安装所有必需环境:
  109. - **Node.js**:未安装则自动下载便携版到 `%APPDATA%/SunnyNet/node/`
  110. - **ADB**:未安装则自动下载 Android Platform Tools 到 `%APPDATA%/SunnyNet/adb/`
  111. - **Frida 依赖**:内置 `frida` + `frida-java-bridge`(已打包在二进制中,无需 npm install)
  112. - **frida-server**:自动检测手机版本,不匹配则下载安装对应版本
  113. ### 日志查看
  114. - 右键点击 **Cloud安卓** 按钮可打开日志窗口,查看所有步骤的详细日志
  115. - 启动失败或 Hook 异常退出时会自动弹出日志窗口
  116. ### 列表显示
  117. - 蓝色上箭头 `→发送`:小程序发出的请求
  118. - 绿色下箭头 `←响应`:微信返回的响应
  119. - 点击条目查看完整 JSON 数据
  120. ### 相关文件
  121. - `cloud_hook.go` — Hook 生命周期管理 + 数据转换
  122. - `adb_frida.go` — ADB 设备管理 + frida-server 部署
  123. - `frida-scripts/` — 嵌入的 JS 注入脚本
  124. ## 项目结构
  125. ```
  126. ├── main.go # Wails 入口
  127. ├── app.go # Wails App 绑定
  128. ├── public.go # GUI↔Go 回调
  129. ├── cloud_hook.go # 安卓云函数 Hook 服务
  130. ├── adb_frida.go # ADB/Frida 设备管理
  131. ├── frida-scripts/ # Frida 注入脚本(嵌入到二进制)
  132. ├── mcp/ # MCP Server 框架(registry, validator, middleware)
  133. │ └── tools/ # MCP 工具实现(request, proxy, breakpoint, replace...)
  134. ├── headless/ # stdio→HTTP MCP 桥接程序
  135. ├── ios-tool/ # iOS 越狱抓包辅助工具
  136. │ ├── hide_proxy.c # CydiaSubstrate 代理检测绕过
  137. │ ├── HideProxy.plist # MobileSubstrate 过滤器
  138. │ └── sunny-tool.sh # iOS 一键 CA 证书+代理配置
  139. ├── CommAnd/ # 平台特定命令(darwin/windows/linux)
  140. ├── MapHash/ # 请求哈希表存储
  141. ├── SunnyNet/ # SunnyNet 核心引擎(内嵌源码)
  142. ├── frontend/ # Vue.js 前端(AG-Grid + Element Plus)
  143. ├── scripts/ # 构建脚本
  144. └── build/ # Wails 构建配置
  145. ```
  146. ## iOS 抓包工具
  147. `ios-tool/` 目录提供越狱 iOS 设备的抓包辅助:
  148. - **hide_proxy.c** — Hook `CFNetworkCopySystemProxySettings()`,让 App 看不到代理设置
  149. - **sunny-tool.sh** — 一键安装 SunnyNet CA 证书到 iOS TrustStore + 配置 WiFi 代理
  150. 详见 [ios-tool/README](ios-tool/) 目录内的源码注释。
  151. ## 致谢
  152. - [SunnyNet](https://github.com/qtgolang/SunnyNet) — 网络中间件核心
  153. - [SunnyNetTools](https://github.com/qtgolang/SunnyNetTools) — GUI 界面原版
  154. - [Wails](https://wails.io/) — Go 桌面应用框架
  155. ## License
  156. MIT

Ratings and comments

Sign in to rate this skill.

Sign in

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