AI导哈

安全分析工具包

Burp MCP安全分析工具包结合Burp Suite的流量捕获和Claude Code的推理能力，通过MCP协议实现专家级的渗透测试方法，适用于网络安全分析和漏洞检测。

  • by SnailSploit
  • Python
  • 本地部署
  • 18 星标
  • 更新于
在 GitHub 查看 SnailSploit/Burp-MCP-Security-Analysis-Toolkit

使用说明

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

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

哲学

原理 说明
技巧胜过提示 技能文件中编码的专家方法，而不是拼凑在一起的提示
分阶段分析 范围>分类>分析>报告（不是一次全部）
所需证据 没有实际HTTP流量的证明，没有发现

快速开始

安装（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

支持的指标

指标 技能档案 它发现了什么
idor SKILL-idor-testing.md 不安全的直接对象引用
bola SKILL-bol-testing.md 对象级授权已损坏
auth_bypass SKILL-auth-analysis.md 身份验证/会话漏洞
ssrf SKILL-ssrf-testing.md 服务器端请求伪造
injection SKILL注入点.md SQLi/XSS/命令注入向量

命令参考

命令 阶段 描述
load scope 1 解析并验证作用域.yaml
triage 2 对端点进行分类并确定优先级
analyze {indicator} 3 运行特定指示符（例如。， analyze idor)
analyze all 3 运行所有启用的指示器
report 4 生成合并报表
full scan 1-4 运行完整的管道
status - 显示当前进度
show endpoints - 显示已分类的端点
inspect {path} - 深入了解特定端点

先决条件

  • 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

  2. 安装MCP服务器扩展

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

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

    brew install caddy

  4. 安装Claude代码

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

  5. 配置MCP

    创建 ~/.claude.json:

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

  6. 配置球童

    创建 ~/.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/:

文件 描述
endpoints.json 带有分数和指标的分型终点
findings/idor.md IDOR特定发现
findings/bola.md BOLA的具体发现
findings/auth.md 认证旁路发现
findings/ssrf.md SSRF发现
findings/injection.md 注射点发现
report.md 综合最终报告

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

学分

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

📚 文档和作者

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

https://snailsploit.com/tools

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

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

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

相关 MCP