Burp Suite MCP-Server

Ein MCP-Server (Model Context Protocol), der die REST-API von Burp Suite als Werkzeuge für KI-Assistenten bereitstellt. Verwenden Sie Cursor oder andere MCP-Clients, um Schwachstellenscans auszulösen, den Fortschritt zu überprüfen und die Sicherheits-Wissensdatenbank von Burp abzufragen.

Voraussetzungen

• Burp Suite Professional (oder Burp Suite DAST) mit aktivierter REST-API

• Python 3.11+

• Burp läuft lokal mit einer REST-API, die an eine erreichbare Adresse gebunden ist (z. B. http://127.0.0.1:1337)

Related MCP server: MCPPentestBOT

Einrichtung

1. Burp REST-API aktivieren

1. Öffnen Sie Burp Suite → Settings → Suite → REST API

2. Aktivieren Sie Service running

3. Legen Sie die URL/den Port fest (z. B. Port 1337)

4. Erstellen Sie einen API-Schlüssel und kopieren Sie ihn

2. Installieren Sie den MCP-Server

uv sync   # or: pip install -e .

3. Umgebung konfigurieren

Kopieren Sie .env.example nach .env und tragen Sie Ihre Werte ein:

cp .env.example .env

Bearbeiten Sie .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

Transportmodi

Der Server unterstützt drei Transportarten, die mit --transport ausgewählt werden:

Für sse und http sind die Bind-Adresse und der Port konfigurierbar:

# 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

Cursor MCP-Konfiguration

stdio (lokaler Prozess)

Fügen Sie dies zu Ihrer Cursor MCP-Konfiguration hinzu (z. B. ~/.cursor/mcp.json oder projektbezogen .cursor/mcp.json):

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

HTTP (entfernter/gemeinsamer Server)

Starten Sie den Server mit HTTP-Transport und verweisen Sie dann Ihren MCP-Client darauf:

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

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

Werkzeuge

Anwendungsbeispiele

URL scannen:

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

Scan-Fortschritt prüfen:

"Check scan progress for task_id 123"

Nur Probleme mit hohem Schweregrad abrufen:

"Check scan 123 and show only high severity issues"

Sicherheitswissen:

"What security issues does Burp know about?"

Befehlszeilennutzung

Führen Sie Scans über Skripte oder das Terminal aus:

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

Verwendete Burp REST-API-Endpunkte

Interaktive API-Dokumentation: [BURP_REST_API_BASE]/[API_KEY]

Lizenz

MIT