Burp MCP Security Analysis Toolkit

Burp MCP安全分析工具包-SnailSploit版

基于技能的安全分析框架 SnailSploit 这结合了 Burp Suite的流量捕获 随着 克劳德·科德的推理 通过MCP（模型上下文协议）。该工具包将专家渗透测试方法编码为可重用的技能文件，而不是临时提示。

哲学

快速开始

安装（macOS/Linux）

# Clone the repository
git clone https://github.com/SnailSploit/Burp-MCP-Security-Analysis-Toolkit.git
cd Burp-MCP-Security-Analysis-Toolkit

# Install Python dependencies
pip install -r requirements.txt

# Run the installer (macOS)
chmod +x install.sh
./install.sh

# Configure your scope
cp templates/scope-template.yaml scope.yaml
# Edit scope.yaml with your target information

# Launch
./launch.sh

CLI使用情况

该工具包包括一个用于独立操作的统一CLI：

# Validate scope configuration
python -m lib validate scope.yaml

# Generate report from findings
python -m lib report ./output

# Run interactive demo
python -m lib demo

# Show version
python -m lib version

Claude代码命令

一旦Burp Suite在启用MCP的情况下运行：

# In Claude Code:
"load scope"      # Validate configuration
"triage"          # Classify endpoints
"analyze all"     # Run all indicator tests
"report"          # Generate final report

目录结构

Burp-MCP-Security-Analysis-Toolkit/
├── CLAUDE.md                    # Orchestration instructions (auto-loaded)
├── README.md                    # This file
├── install.sh                   # macOS installer
├── launch.sh                    # Launcher script (created by installer)
├── scope.yaml                   # Your engagement config (create from template)
│
├── skills/                      # Methodology files (~80KB of expertise)
│   ├── SKILL-burp-mcp.md        # MCP query patterns
│   ├── SKILL-endpoint-triage.md # Endpoint classification
│   ├── SKILL-idor-testing.md    # IDOR detection methodology
│   ├── SKILL-bola-testing.md    # Broken Object Level Authorization
│   ├── SKILL-auth-analysis.md   # Auth bypass testing
│   ├── SKILL-ssrf-testing.md    # SSRF detection
│   ├── SKILL-injection-points.md# SQLi/XSS vector identification
│   └── SKILL-report-format.md   # Report generation format
│
├── lib/                         # Python helpers
│   ├── __init__.py              # Package exports (v2.1.0)
│   ├── __main__.py              # CLI entry point
│   ├── scope_validator.py       # Validate scope.yaml
│   ├── endpoint_filter.py       # Filter/prioritize endpoints
│   ├── finding_formatter.py     # Format findings to markdown
│   └── report_generator.py      # Aggregate findings into report
│
├── tests/                       # Test suite
│   ├── test_scope_validator.py  # Scope validation tests
│   ├── test_endpoint_filter.py  # Endpoint filtering tests
│   ├── test_finding_formatter.py# Finding formatting tests
│   └── test_report_generator.py # Report generation tests
│
├── templates/
│   ├── scope-template.yaml      # Blank scope configuration
│   └── finding-template.md      # Finding documentation format
│
└── output/                      # Generated during analysis
    ├── endpoints.json           # Triaged endpoint list
    ├── findings/                # Per-indicator findings
    └── report.md                # Final consolidated report

支持的指标

命令参考

先决条件

• macOS （英特尔或苹果硅）或 Linux
• Python 3.9+
• Burp Suite 社区或专业
• 克劳德代码 （npm包）
• 捕获的HTTP流量 通过Burp代理
• 多个身份验证上下文 （用于IDOR/BOLA测试）

安装指南

选项1：自动（macOS）

./install.sh

这将安装：Homebrew、Burp Suite、Caddy、Node.js、Claude Code，并配置MCP。

选项2：手动

1. 安装Burp套件

   brew install --cask burp-suite

1. 安装MCP服务器扩展

- 打开Burp>扩展器>BApp商店 - 搜索“MCP服务器”>安装 - 出口 mcp-proxy.jar 到 ~/.burp-mcp-extension/

1. 安装球童 （反向代理）

   brew install caddy

1. 安装Claude代码

   npm install -g @anthropic-ai/claude-code

1. 配置MCP

创建 ~/.claude.json:

   {
     "mcpServers": {
       "burp": {
         "command": "/path/to/java",
         "args": ["-jar", "/path/to/mcp-proxy.jar", "--", "http://localhost:9877/mcp"]
       }
     }
   }

1. 配置球童

创建 ~/.config/caddy/Caddyfile:

   :9877 {
       reverse_proxy localhost:9876 {
           header_up -Origin
       }
   }

配置

复制并编辑范围模板：

cp templates/scope-template.yaml scope.yaml

关键部分：

• 目标：主域和其他主机
• 范围：包括/排除路径模式
• 指标：要测试哪些漏洞类型
• 认证：IDOR/BOLA测试的多用户令牌

看 templates/scope-template.yaml 查看带有示例的完整文档。

输出

所有调查结果均已发送至 output/:

Python助手

这 lib/ 目录包含可通过CLI访问的独立Python实用程序：

# Unified CLI
python -m lib validate scope.yaml
python -m lib report output/
python -m lib demo
python -m lib version

# Direct module usage
python lib/scope_validator.py scope.yaml
python lib/report_generator.py output/

测试

运行完整的测试套件：

pip install pytest
python -m pytest tests/ -v

延伸

添加新指标

1. 创建 skills/SKILL-{indicator}-testing.md 方法论
2. 添加 indicators.enabled 在scope-template.yaml中
3. 使用新技能参考更新CLAUDE.md

定制技能

遵循现有技能的结构：

• 目的和范围
• 先决条件
• 循序渐进的方法
• 证据要求
• 输出格式

安全说明

• 作用域文件包含令牌 -添加 scope.yaml 到 .gitignore
• 仅在授权目标上使用 -标准渗透测试规则适用
• 默认情况下，证据会被编辑 -在scope.yaml中配置

许可证

MIT许可证-请参阅 许可证

贡献

欢迎投稿！看 贡献.md

学分

• SnailSploit -框架作者和维护者
• 凯·艾森 -原始工具包概念

______________________________________________________________________

免责声明： 负责任地使用，并且只在您有明确测试权限的系统上使用。

______________________________________________________________________

📚 文档和作者

该项目的完整报告、方法论和相关研究位于：

https://snailsploit.com/tools

由...创建 凯·艾森 --独立攻击性安全研究员。

snailsploit.com · 研究 · 框架 · · 领英 · 研究之门 · X/推特

*同样的攻击。不同的基材。*