
把 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
- 下载
burp-mcp-bridge-1.0.0.jar(从 Releases 页面) - Burp Suite → Extender → Extensions → Add → Type: Java
- 选择 jar → Next
- 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... 覆盖) |
|---|
安装
This server does not publish a one-line install command.
Open the repository installation guide 新手?先看 mcpskill.org 教程 →