local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses .env files for configuration management, allowing customization of server settings, BurpSuite API connection details, and proxy settings.
Supports command-line interaction with the server's endpoints using curl commands for intercepting requests, viewing proxy history, starting scans, and analyzing logs.
Built on FastAPI to provide a web API interface for BurpSuite functionality, with Swagger UI and ReDoc documentation available.

Servidor MCP de BurpSuite

Una potente implementación de servidor de Protocolo de contexto de modelo (MCP) para BurpSuite, que proporciona acceso programático a las funcionalidades principales de Burp.

🚀 Características

Herramienta proxy

Interceptar y modificar el tráfico HTTP/HTTPS
Ver y manipular solicitudes/respuestas
Acceder al historial de proxy
Manipulación de solicitudes/respuestas en tiempo real

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

Herramienta de escáner

Escaneo activo y pasivo
Configuraciones de escaneo personalizadas
Seguimiento de problemas en tiempo real
Monitoreo del estado del escaneo

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

Herramienta de registro

Registro completo del tráfico HTTP
Filtrado y búsqueda avanzados
Detección de vulnerabilidades
Análisis de tráfico
Detección de patrones sospechosos

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

🎯 Detección de vulnerabilidades

Detecta automáticamente múltiples tipos de vulnerabilidades:

🔥 XSS (Scripting entre sitios)
💉 Inyección SQL
🗂️ Recorrido de caminos
📁 Inclusión de archivos
🌐 SSRF (falsificación de solicitud del lado del servidor)
📄 XXE (Entidad externa XML)
🔒 CSRF (falsificación de solicitud entre sitios)
🔄 Abrir redirección
⚡ Inyección de comandos

🛠️ Configuración

Clonar el repositorio

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

Instalar dependencias

pip install -r requirements.txt

Configurar el entorno

# 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

Iniciar el servidor

python main.py

El servidor se iniciará en http://localhost:8000

📊 Funciones de análisis

Análisis de tráfico

Recuento total de solicitudes
URL únicas
Distribución de métodos HTTP
Distribución del código de estado
Análisis del tipo de contenido
Tiempo promedio de respuesta

Análisis de vulnerabilidad

Resumen del tipo de vulnerabilidad
Principales puntos finales vulnerables
Patrones sospechosos
Detección de vulnerabilidades en tiempo real

Filtrado de registros

Por método HTTP
Por código de estado
Por patrón de URL
Por tipo de contenido
Por longitud del contenido
Por rango de tiempo
Por tipo de vulnerabilidad

Consideraciones de seguridad

Ejecutar en un entorno seguro
Configurar la autenticación adecuada
Utilice HTTPS en producción
Mantenga segura la clave API de BurpSuite
Supervisar y auditar el acceso

Documentación de la API

Para obtener documentación detallada de la API, visita:

Interfaz de usuario Swagger: http://localhost:8000/docs
ReDoc: http://localhost:8000/redoc

Integración del cursor

El servidor MCP está configurado para funcionar sin problemas con Cursor IDE. El directorio .cursor contiene todos los archivos de configuración necesarios:

Archivos de configuración

settings.json : contiene la configuración del servidor MCP
- Configuración del host y del puerto del servidor
- Configuraciones de puntos finales
- Configuración de proxy de BurpSuite
- Configuración del registrador
- Ruta del intérprete de Python
tasks.json : Define tareas comunes
- Iniciar el servidor MCP
- Ejecutar pruebas de vulnerabilidad
- Comprobar vulnerabilidades
launch.json : Contiene configuraciones de depuración
- Depurar el servidor MCP
- Pruebas de vulnerabilidad de depuración

Uso en el cursor

Abra el proyecto en Cursor
La configuración del servidor MCP se cargará automáticamente
Acceda a las funciones a través de:
- Paleta de comandos (Ctrl+Shift+P) para ejecutar tareas
- Menú de depuración para sesiones de depuración
- Configuración automática del intérprete de Python

El servidor será accesible en http://localhost:8000 con los siguientes puntos finales:

/proxy/intercept para interceptar solicitudes
/logger para la funcionalidad de registro
/logger/vulnerabilities/severity para el análisis de vulnerabilidades

📝 Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

🙏 Agradecimientos

BurpSuite : la herramienta original para pruebas de seguridad
FastAPI - El marco web utilizado
Python - El lenguaje de programación utilizado

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Servidor MCP de BurpSuite: una potente implementación de servidor de Protocolo de contexto de modelo (MCP) para BurpSuite, que proporciona acceso programático a las funcionalidades principales de Burp.

BurpSuite MCP Server