# BurpSuite MCP 服务器
## 基本信息
- Slug: `x3r0k-burpsuite-mcp-server`
- Source: modelscope
- Publisher: @X3r0K/BurpSuite-MCP-Server
- Categories: security-and-iam / browser-automation / monitoring
- Hosted: No
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@X3r0K/BurpSuite-MCP-Server
## 简介
BurpSuite MCP服务器：BurpSuite的强大模型上下文协议（MCP）服务器实现，提供对Burp核心功能的编程访问。
## 安装提示

```bash
# 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" ``` ### 🔍 扫描工具 - 主动和被动扫描 - 自定义扫描配置 - 实时问题跟踪 - 扫描状态监控 ```bash # 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 流量日志 - 高级过滤和搜索 - 漏洞检测 - 流量分析 - 可疑模式检测 ```bash # 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. **克隆仓库** ```bash git clone https://github.com/X3r0K/BurpSuite-MCP-Server.git cd BurpSuite-MCP-Server
```

## MCP Server 详情

# 🛡️ BurpSuite MCP 服务器

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

[![Python](https://img.shields.io/badge/python-3.8+-blue.svg)](https://www.python.org/downloads/)
[![FastAPI](https://img.shields.io/badge/FastAPI-0.104.1-green.svg)](https://fastapi.tiangolo.com/)
[![License](https://img.shields.io/badge/license-MIT-yellow.svg)](LICENSE)

## 🚀 特性

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

```bash
# 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"
```


### 🔍 扫描工具
- 主动和被动扫描
- 自定义扫描配置
- 实时问题跟踪
- 扫描状态监控

```bash
# 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 流量日志
- 高级过滤和搜索
- 漏洞检测
- 流量分析
- 可疑模式检测

```bash
# 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. **克隆仓库**

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


1. **安装依赖**
```bash
pip install -r requirements.txt
```


2. **配置环境**
```bash
# 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
```


3. **启动服务器**
```bash
python main.py
```


服务器将在 [http://localhost:8000](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
![image](https://github.com/user-attachments/assets/a9af7fb9-b840-40ef-b8b7-b24a9bcbc72a)


## 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` 用于漏洞分析

![image](https://github.com/user-attachments/assets/7e006b2a-a9f7-4d09-85da-fd6fea5d352c)


![image](https://github.com/user-attachments/assets/e3376c42-5966-4fe8-a1d0-08916bd60b06)


## 📝 许可证

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

## 🙏 致谢

- [BurpSuite](https://portswigger.net/burp) - 原始的安全测试工具
- [FastAPI](https://fastapi.tiangolo.com/) - 使用的Web框架
- [Python](https://www.python.org/) - 使用的编程语言