Servidor MCP de Burp Suite

Un servidor MCP (Model Context Protocol) que expone la API REST de Burp Suite como herramientas para asistentes de IA. Utiliza Cursor u otros clientes MCP para iniciar escaneos de vulnerabilidades, verificar el progreso y consultar la base de conocimientos de seguridad de Burp.

Requisitos previos

• Burp Suite Professional (o Burp Suite DAST) con la API REST habilitada

• Python 3.11+

• Burp ejecutándose localmente con la API REST vinculada a una dirección accesible (ej. http://127.0.0.1:1337)

Related MCP server: MCPPentestBOT

Configuración

1. Habilitar la API REST de Burp

1. Abre Burp Suite → Settings → Suite → REST API

2. Marca Service running

3. Establece la URL/puerto (ej. puerto 1337)

4. Crea una clave API y cópiala

2. Instalar el servidor MCP

uv sync   # or: pip install -e .

3. Configurar el entorno

Copia .env.example a .env y rellena tus valores:

cp .env.example .env

Edita .env:

BURP_REST_API_BASE=http://127.0.0.1:1337
BURP_REST_API_KEY=your-api-key-here
BURP_REST_API_VERSION=v0.1

Modos de transporte

El servidor admite tres transportes, seleccionados con --transport:

Para sse y http, la dirección de enlace y el puerto son configurables:

# Default: localhost only, port 8000
uv run python main.py --transport http

# Expose on all interfaces, custom port
uv run python main.py --transport http --host 0.0.0.0 --port 9000

# SSE transport
uv run python main.py --transport sse --host 127.0.0.1 --port 8000

Configuración de MCP en Cursor

stdio (proceso local)

Añádelo a tu configuración de MCP en Cursor (ej. ~/.cursor/mcp.json o project .cursor/mcp.json):

{
  "mcpServers": {
    "burp-suite": {
      "command": "uv",
      "args": ["run", "python", "/path/to/burp-mcp/main.py"],
      "cwd": "/path/to/burp-mcp"
    }
  }
}

HTTP (servidor remoto/compartido)

Inicia el servidor con transporte HTTP, luego apunta tu cliente MCP hacia él:

uv run python main.py --transport http --host 0.0.0.0 --port 8000

{
  "mcpServers": {
    "burp-suite": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

Herramientas

Ejemplos de uso

Escanear una URL:

"Scan https://example.com for vulnerabilities"

Verificar el progreso del escaneo:

"Check scan progress for task_id 123"

Obtener solo problemas de alta severidad:

"Check scan 123 and show only high severity issues"

Conocimiento de seguridad:

"What security issues does Burp know about?"

Uso desde la línea de comandos

Ejecuta escaneos desde scripts o la terminal:

uv run python examples/ci-scan.py https://your-target.com
# or
./examples/ci-scan.sh https://your-target.com

Endpoints de la API REST de Burp utilizados

Documentación interactiva de la API: [BURP_REST_API_BASE]/[API_KEY]

Licencia

MIT