🛡️ BurpSuite MCP 服务器

一个强大的模型上下文协议 (MCP) 服务器实现，为 BurpSuite 提供程序化访问其核心功能的接口。

🚀 特性

🔄 代理工具

• 拦截和修改 HTTP/HTTPS 流量
• 查看和操作请求/响应
• 访问代理历史记录
• 实时请求/响应操作

# Intercept a request
curl -X POST "http://localhost:8000/proxy/intercept" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://example.com",
    "method": "GET",
    "headers": {"User-Agent": "Custom"},
    "intercept": true
  }'

# View proxy history
curl "http://localhost:8000/proxy/history"

🔍 扫描工具

• 主动和被动扫描
• 自定义扫描配置
• 实时问题跟踪
• 扫描状态监控

# Start a new scan
curl -X POST "http://localhost:8000/scanner/start" \
  -H "Content-Type: application/json" \
  -d '{
    "target_url": "https://example.com",
    "scan_type": "active",
    "scan_configurations": {
      "scope": "strict",
      "audit_checks": ["xss", "sqli"]
    }
  }'

# Check scan status
curl "http://localhost:8000/scanner/status/scan_1"

# Stop a scan
curl -X DELETE "http://localhost:8000/scanner/stop/scan_1"

📝 日志工具

• 全面的 HTTP 流量日志
• 高级过滤和搜索
• 漏洞检测
• 流量分析
• 可疑模式检测

# Get filtered logs
curl "http://localhost:8000/logger/logs?filter[method]=POST&filter[status_code]=200"

# Search logs
curl "http://localhost:8000/logger/logs?search=password"

# Get vulnerability analysis
curl "http://localhost:8000/logger/vulnerabilities"

# Get comprehensive analysis
curl "http://localhost:8000/logger/analysis"

# Clear logs
curl -X DELETE "http://localhost:8000/logger/clear"

curl "http://localhost:8000/logger/vulnerabilities/severity"

🎯 漏洞检测

自动检测多种类型的漏洞：

• 🔥 XSS（跨站脚本攻击）
• 💉 SQL 注入
• 🗂️ 路径遍历
• 📁 文件包含
• 🌐 SSRF（服务器端请求伪造）
• 📄 XXE（XML 外部实体）
• 🔒 CSRF（跨站请求伪造）
• 🔄 开放重定向
• ⚡ 命令注入

🛠️ 安装

1. 克隆仓库

git clone https://github.com/X3r0K/BurpSuite-MCP-Server.git
cd BurpSuite-MCP-Server

1. 安装依赖

pip install -r requirements.txt

1. 配置环境

# Copy .env.example to .env
cp .env.example .env

# Update the values in .env
BURP_API_KEY=Your_API_KEY
BURP_API_HOST=localhost
BURP_API_PORT=1337
BURP_PROXY_HOST=127.0.0.1
BURP_PROXY_PORT=8080
MCP_SERVER_HOST=0.0.0.0
MCP_SERVER_PORT=8000

1. 启动服务器

python main.py

服务器将在 http://localhost:8000 上启动

📊 分析特性

流量分析

• 总请求数
• 唯一 URL 数
• HTTP 方法分布
• 状态码分布
• 内容类型分析
• 平均响应时间

漏洞分析

• 漏洞类型汇总
• 最易受攻击的端点
• 可疑模式
• 实时漏洞检测

日志过滤

• 按 HTTP 方法
• 按状态码
• 按 URL 模式
• 按内容类型
• 按内容长度
• 按时间范围
• 按漏洞类型

🔒 安全注意事项

1. 在安全环境中运行
2. 配置适当的认证
3. 在生产环境中使用 HTTPS
4. 保护好 BurpSuite API 密钥
5. 监控并审计访问

📚 API 文档

详细的 API 文档，请访问：

• Swagger UI: http://localhost:8000/docs
• ReDoc: http://localhost:8000/redoc

Cursor 集成

MCP 服务器已配置为与 Cursor IDE 无缝协作。.cursor 目录中包含了所有必要的配置文件：

配置文件

1. settings.json: 包含MCP服务器配置

   • 服务器主机和端口设置
   • 端点配置
   • BurpSuite代理设置
   • 日志记录器设置
   • Python解释器路径

2. tasks.json: 定义常用任务

   • 启动MCP服务器
   • 运行漏洞测试
   • 检查漏洞

3. launch.json: 包含调试配置

   • 调试MCP服务器
   • 调试漏洞测试

在Cursor中使用

1. 在Cursor中打开项目
2. MCP服务器配置将自动加载
3. 通过以下方式访问功能：
   • 命令面板（Ctrl+Shift+P）运行任务
   • 调试菜单进行调试会话
   • 自动Python解释器配置

服务器将在http://localhost:8000上可访问，具有以下端点：

• /proxy/intercept 用于请求拦截
• /logger 用于日志功能
• /logger/vulnerabilities/severity 用于漏洞分析

📝 许可证

此项目根据MIT许可证发布 - 详情请参阅LICENSE文件。

🙏 致谢

• BurpSuite - 原始的安全测试工具
• FastAPI - 使用的Web框架
• Python - 使用的编程语言