Burp MCP Ultra

BurpMCP-Ultra

The most powerful MCP server for Burp Suite Professional

137 Tools • 14 Resources • 12 Event Types • Real-time Dashboard • Full Montoya API Coverage

Quick Start • All Tools • Features • Dashboard • Setup Guides

______________________________________________________________________

BurpMCP Ultra 是一个带有嵌入式MCP（模型上下文协议）服务器的原生Kotlin Burp Suite扩展。将单个JAR放入Burp，连接Claude Code或任何MCP客户端，并通过AI代理以编程方式控制Burp Suite的各个方面。

为什么选择BurpMCP Ultra？

______________________________________________________________________

快速开始

1.建造

git clone https://github.com/Cy-S3c/BurpMCP-Ultra.git
cd BurpMCP-Ultra
./gradlew shadowJar

输出： build/libs/burpmcp-ultra-2.0.1.jar （13 MB）

2.装入Burp

1. Burp Suite Pro> 扩展 > 添加
2. 选择JAR
3. BurpMCP Ultra 选项卡显示绿色“正在运行”状态

3.连接克劳德代码

{
  "mcpServers": {
    "burp": {
      "type": "sse",
      "url": "http://127.0.0.1:9876/sse"
    }
  }
}

添加 ~/.claude.json 或者你的项目 .mcp.json.

4.打开仪表板

浏览至 http://127.0.0.1:9878 用于实时网络仪表板。

______________________________________________________________________

设置指南

Claude Code (Direct SSE)

最简单的设置。添加到MCP配置中：

{
  "mcpServers": {
    "burp": {
      "type": "sse",
      "url": "http://127.0.0.1:9876/sse"
    }
  }
}

配置文件位置：

• 全球的： ~/.claude.json
• 每个项目： .mcp.json 在项目根中

Claude Code via Caddy (Recommended for Stability)

Caddy可防止SSE超时断开连接，并提供可靠的缓冲。

安装球童：

sudo apt install caddy

创建 /etc/caddy/Caddyfile:

:9900 {
    reverse_proxy 127.0.0.1:9876 {
        transport http {
            read_timeout 0
            write_timeout 0
            response_header_timeout 0
        }
        flush_interval -1
        header_up Connection {>Connection}
        header_up Upgrade {>Upgrade}
    }
}

sudo systemctl restart caddy

然后在MCP配置中使用端口9900：

{
  "mcpServers": {
    "burp": {
      "type": "sse",
      "url": "http://127.0.0.1:9900/sse"
    }
  }
}

预构建的Caddyfile包括： configs/Caddyfile

Claude Desktop (stdio via proxy)

Claude Desktop仅支持stdio传输。使用超级通道作为桥梁：

{
  "mcpServers": {
    "burp": {
      "command": "npx",
      "args": ["-y", "supergateway", "--sse", "http://127.0.0.1:9876/sse"]
    }
  }
}

Automated Setup Script

chmod +x configs/setup.sh
./configs/setup.sh

该脚本构建JAR，可选地配置Caddy，并显示要添加的MCP配置。

______________________________________________________________________

全部137工具

代理（13个工具）

HTTP（13个工具）

扫描仪（12个工具）

实用程序（13个工具）

B检查模式（5个工具）

脚本模式（5个工具）

协作者（6个工具）

分析（7个工具）+高级（3个工具）

WebSocket（7个工具）

配置和BurpSuite（16个工具）

其他（22工具）

______________________________________________________________________

突出显示功能

比赛条件测试

http_race(
  request: "POST /api/transfer HTTP/1.1\r\nHost: bank.com\r\n\r\n{\"amount\":100}",
  host: "bank.com", port: 443, count: 20
)

使用Burp的并行引擎同时发送20个相同的请求。分析响应状态代码和正文长度分布，以检测TOCTU、双重花费和限制绕过漏洞。

身份验证级别差异

auth_diff(
  request: "GET /api/users/1 HTTP/1.1\r\nHost: api.com\r\n\r\n",
  host: "api.com", port: 443,
  auth_levels: [
    {"name": "admin", "header_name": "Authorization", "header_value": "Bearer admin-token"},
    {"name": "user", "header_name": "Authorization", "header_value": "Bearer user-token"},
    {"name": "none"}
  ]
)

发送具有不同身份验证级别的相同请求，比较响应，并标记IDOR、权限升级和缺少授权。

直列式引信（3种模式）

# Mode 1: FUZZ keyword — simplest
http_fuzz(request: "GET /api?id=FUZZ HTTP/1.1\r\nHost: api.com\r\n\r\n",
          host: "api.com", port: 443,
          payloads: ["1", "2", "admin", "../../etc/passwd"])

# Mode 2: Section markers — like Burp Intruder
http_fuzz(request: "GET /api?id=§1§&role=§user§ HTTP/1.1\r\nHost: api.com\r\n\r\n",
          host: "api.com", port: 443,
          payloads: ["admin"])

# Mode 3: Byte offsets — precise control
http_fuzz(request: "GET /status/200 HTTP/1.1\r\nHost: httpbin.org\r\n\r\n",
          host: "httpbin.org", port: 443,
          positions: [[12, 15]], payloads: ["201", "404"])

自定义扫描检查

B检查模式 --使用Burp的BCheck DSL部署漏洞检查：

bcheck_create(
  name: "AWS Key Leak", type: "passive_response",
  match_pattern: "AKIA[0-9A-Z]{16}",
  severity: "high", confidence: "firm",
  issue_detail: "AWS Access Key ID found in response"
)

脚本模式 --带有条件有效载荷的多步骤主动检查：

scancheck_create_active(
  name: "SSTI Detection",
  steps: [
    {"payload": "{{7*7}}", "response_conditions": [
      {"location": "response_body", "pattern": "49", "condition_type": "contains"}
    ]},
    {"payload": "{{7*6}}", "response_conditions": [
      {"location": "response_body", "pattern": "42", "condition_type": "contains"}
    ]}
  ],
  severity: "high", confidence: "firm"
)

API架构导入

api_import_openapi(
  spec_json: "",
  auth_header: "Authorization",
  auth_value: "Bearer your-token",
  send_requests: true,
  add_to_sitemap: true
)

解析OpenAPI 3.x和Swagger 2.0规范。为每个端点生成带有示例参数和主体的请求。可以选择通过Burp发送它们，填充代理历史记录和站点地图。

被动情报提取

passive_intel(max_items: 2000, in_scope_only: true)

扫描所有捕获的代理流量，查找30多种敏感数据模式：

• 云凭据：AWS密钥、Google API密钥、GitHub令牌、Slack令牌、Stripe密钥
• 代币和秘密：JWT、承载令牌、基本身份验证、私钥
• 个人资料：电子邮件、内部IP地址、电话号码
• 云资源：S3存储桶、Azure存储、GCS存储桶
• 基础设施：内部URL、GraphQL端点、API路径
• 错误：堆栈跟踪、SQL错误、调试信息
• 指纹：服务器版本、框架版本、PHP版本
• 敏感路径：/admin、/.env、/.git、/debug、/axecutor

______________________________________________________________________

网络仪表盘

打开 http://127.0.0.1:9878 对于实时仪表板：

• 实时活动流 具有噪声过滤功能（自动隐藏Google/Apple/Microsoft连接检查）
• 攻击向量检测 -AUTH、API、PARMS、UPLOAD、ADMIN、DATA端点的徽章
• 请求详细信息面板 --单击任何项目以获取完整的请求信息+发送到工具操作
• 统计栏 -事件、范围内主机和攻击向量类别的实时计数器
• 过滤器控制 --类型过滤器、URL搜索、噪声切换
• 主动规则 --查看所有代理、流量和会话规则
• 连接信息 --传输URL和MCP客户端配置

______________________________________________________________________

建筑

+---------------------------------------------------+
|                BURP SUITE PRO                      |
|  +---------------------------------------------+  |
|  |        BurpMCP-Ultra Extension               |  |
|  |                                              |  |
|  |  Montoya API --> Bridge Layer (22 bridges)   |  |
|  |       |                |                     |  |
|  |  Event Bus    Tool Registry (137 tools)      |  |
|  |       |                |                     |  |
|  |       +------- MCP Server Core --------+     |  |
|  |               (Kotlin SDK 0.8.3)       |     |  |
|  |                    |                   |     |  |
|  |         +----------+----------+        |     |  |
|  |     SSE :9876  SSE :9877  Dashboard    |     |  |
|  |                            :9878       |     |  |
|  +---------------------------------------------+  |
+---------------------------------------------------+

技术栈

需求

• Burp Suite Professional 2025.x或更高版本
• Java 17+（包含在Burp捆绑的JRE中）
• Gradle 8.x（包装内含）

从源头构建

git clone https://github.com/Cy-S3c/BurpMCP-Ultra.git
cd BurpMCP-Ultra
./gradlew shadowJar
# Output: build/libs/burpmcp-ultra-2.0.1.jar

项目结构

BurpMCP-Ultra/
├── build.gradle.kts              # Build configuration
├── configs/                      # Ready-to-use config files
│   ├── Caddyfile                 # Caddy reverse proxy
│   ├── mcp-claude-code-direct.json
│   ├── mcp-claude-code-caddy.json
│   ├── mcp-claude-desktop.json
│   └── setup.sh                  # Automated setup
├── src/main/kotlin/com/burpmcp/ultra/
│   ├── core/                     # Extension entry point + helpers
│   ├── bridge/                   # 22 Montoya API bridges
│   ├── tools/                    # 29 tool category modules
│   ├── transport/                # MCP server + dashboard
│   ├── events/                   # Unified event bus
│   ├── state/                    # State management
│   └── ui/                       # Swing UI tab
└── docs/                         # Tool catalog + plans

许可证

麻省理工学院

______________________________________________________________________

Built for bug bounty hunters who want AI-powered Burp Suite automation.