AB

a4n9g7e2l/burp-mcp-bridge

开发工具

本页由 AI 翻译,技术细节请以原文为准。 查看原文

36 stars 4 forks 质量 49 趋势 16NOASSERTION

把 Burp Suite 33 个插件(26 核心 + 7 Phase 3 高级工具)通过 MCP 协议桥接到 AI 客户端

概览

把 Burp Suite 的 (26 核心 + 7 Phase 3 高级工具)通过 MCP 协议桥接到 AI 客户端,让 @burp-suite-arsenal 等 agent 真正“看到” Burp 的全部武器。 完整端到端实测见 docs/demo-phase3.md — 32/33 工具真实调用 PASS。ZCode 是命令行 IDE 无法直接截图,文档含 Mermaid 架构图 + 真实 JSON 输出。 官方 burp-mcp-all.jar(PortSwigger 官方)只能暴露 Burp 核心(Proxy/Repeater/Intruder/Scanner/Collaborator),。本项目通过 Montoya API 主动读取插件的标注/日志/发现,弥补这个空白。 - Burp Suite Pro 2026.6+(Montoya API)- JDK 21(编译用)+ Python 3.10+(运行时)- ZCode IDE 1. 下载 burp-mcp-bridge-1.0.0.jar(从 Releases 页面) 2.Burp Suite → 扩展器 → 扩展 → 添加 →类型:Java 3.选择 jar → Next 4.输出标签应看到 “注册了 25 个工具” + “MCP SSE 服务已启动,端口 9877” 编辑 ~/.zcode/cli/config.json 的 mcp.servers,添加: Python 路径按本机实际调整;脚本会监听 stdin 的 JSON-RPC,转发到 Burp 端口 9877。 完全关闭后重开,@burp-suite-arsenal 即可调用 mcp__* 工具(26 基础 + 7 Phase 3 高级)。

概述(AI 翻译)

把 Burp Suite 的 33 个能力(26 核心 + 7 Phase 3 高级工具)通过 MCP 协议桥接到 AI 客户端,让 @burp-suite-arsenal 等 agent 真正“看到” Burp 的全部武器。

完整端到端实测见 docs/demo-phase3.md — 32/33 工具真实调用 PASS。ZCode 是命令行 IDE 无法直接截图,文档含 Mermaid 架构图 + 真实 JSON 输出。

✨ 核心特性

🔌 桥接官方 burpsuite MCP 27 工具的空白

官方 burp-mcp-all.jar(PortSwigger 官方)只能暴露 Burp 核心(Proxy/Repeater/Intruder/Scanner/Collaborator),不暴露 BApp 商店的第三方插件。本项目通过 Montoya API 主动读取插件的标注/日志/发现,弥补这个空白。

🎯 33 个差异化工具(26 核心 + 7 Phase 3 高级)

类别 工具 桥接的 Burp 插件 / 能力
Shiro shiro_detect / shiro_exploit 读 BurpShiroPassiveScan 标注 + gadget chain payload 生成
Fastjson fastjson_detect 读 FastjsonScan 标注 + 响应特征
WAF waf_bypass 7 种绕过变体(编码/Unicode/注释拆分/chunked 等)
请求走私 smuggler_detect CL.TE / TE。CL 探测有效载荷
JWT jwt_decode / jwt_forge / jwt_bruteforce 标准 JWT 解码 + alg:none 伪造 + 密钥爆破
被动标注 hae_get_highlights / domain_hunter_get_results / xkeys_get_findings 读 HaE / domain_hunter / Xkeys 插件输出
扫描调度 active_scan_start / active_scan_get_status / get_scan_issues_enhanced / get_scan_queue 主动扫描 + 结果读取

本页由 AI 翻译,技术细节请以原文为准。

README

以下为原文 README 节选,完整内容请查看原文。

Burp MCP Bridge

把 Burp Suite 的 33 个能力(26 核心 + 7 Phase 3 高级工具)通过 MCP 协议桥接到 AI 客户端,让 @burp-suite-arsenal 等 agent 真正"看到" Burp 的全部武器。

完整端到端实测见 docs/demo-phase3.md — 32/33 工具真实调用 PASS。ZCode 是命令行 IDE 无法直接截图,文档含 Mermaid 架构图 + 真实 JSON 输出。

✨ 核心特性

🔌 桥接官方 burpsuite MCP 27 工具的空白

官方 burp-mcp-all.jar(PortSwigger 官方)只能暴露 Burp 核心(Proxy/Repeater/Intruder/Scanner/Collaborator),不暴露 BApp 商店的第三方插件。本项目通过 Montoya API 主动读取插件的标注/日志/发现,弥补这个空白。

🎯 33 个差异化工具(26 核心 + 7 Phase 3 高级)

类别 工具 桥接的 Burp 插件 / 能力
Shiro shiro_detect / shiro_exploit 读 BurpShiroPassiveScan 标注 + gadget chain payload 生成
Fastjson fastjson_detect 读 FastjsonScan 标注 + 响应特征
WAF waf_bypass 7 种绕过变体(编码/Unicode/注释拆分/chunked 等)
请求走私 smuggler_detect CL.TE / TE.CL 探测 payload
JWT jwt_decode / jwt_forge / jwt_bruteforce 标准 JWT 解码 + alg:none 伪造 + 密钥爆破
被动标注 hae_get_highlights / domain_hunter_get_results / xkeys_get_findings 读 HaE / domain_hunter / Xkeys 插件输出
扫描调度 active_scan_start / active_scan_get_status / get_scan_issues_enhanced / get_scan_queue 主动扫描 + 结果读取
Intruder intruder_start / intruder_get_results 攻击编排 + 结果
目标管理 get_target_sitemap / get_scope / add_to_scope / get_target_issues 站点地图 + 范围 + 漏洞
流量 get_all_proxy_history / get_annotated_items 代理历史 + 染色标注
💥 Phase 3 高速攻击 turbo_intruder_run TI 脚本调度(attack_id)
🗄️ Phase 3 SQL 注入 sqlmap_run 100% 调 sqlmap.py 全参数
🖼️ Phase 3 验证码 captcha_solve 100% 调 ddddocr(图片 → 文字)
🧮 Phase 3 前端加密 js_encrypt GraalVM JS 引擎执行 JS 函数
📤 Phase 3 文件上传 upload_test multipart 4 变体(.php/.php.jpg/.phtml/%00.jpg)
🔓 Phase 3 越权 authorizer_run 双 cookie IDOR 自动检测
✅ Phase 3 POC 验证 poc_verify_xpoc 100% 跑 xpoc.exe 云端 POC 库

📦 安装

前置条件

  • Burp Suite Pro 2026.6+(Montoya API)
  • JDK 21(编译用)+ Python 3.10+(运行时)
  • ZCode IDE

步骤 1:加载到 Burp Suite

  1. 下载 burp-mcp-bridge-1.0.0.jar(从 Releases 页面)
  2. Burp Suite → Extender → Extensions → Add → Type: Java
  3. 选择 jar → Next
  4. Output 标签应看到 “Registered 25 tools” + “MCP SSE 服务已启动,端口 9877”

步骤 2:注册到 ZCode

编辑 ~/.zcode/cli/config.json 的 mcp.servers,添加:

"mcpBridge": {
  "enabled": true,
  "type": "stdio",
  "command": "C:\\Users\\AppData\\Local\\Programs\\Python\\Python312\\python.exe",
  "args": ["D:\\claude code\\burp-mcp-bridge\\scripts\\mcp-bridge-stdio.py"]
}

Python 路径按本机实际调整;脚本会监听 stdin 的 JSON-RPC,转发到 Burp 端口 9877。

步骤 3:重启 ZCode

完全关闭后重开,@burp-suite-arsenal 即可调用 33 个 mcp__mcpBridge__* 工具(26 基础 + 7 Phase 3 高级)。

Phase 3 工具外部依赖(可选)

Phase 3 的 4 个工具需要外部二进制。这些依赖是可选的 —— 如果没装,对应工具返回明确错误信息,其他 26 个基础工具仍正常工作。

工具 外部依赖 默认路径(可通过 JVM -D... 覆盖)
在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手?先看 mcpskill.org 教程 →