nuclei-mcp

Ein bereichsbeschränkter Nuclei MCP-Server, der sich weigert, irgendetwas zu scannen, das nicht in Ihren HackerOne-Scope-Snapshots gefunden wurde. Funktioniert als Begleiter zu h1-scope-watcher.

Architektur

Copilot/Claude (AI agent)
    │
    │  MCP (stdio)
    ▼
nuclei-mcp container
    │  reads scope
    ├──────────────────► /data/snapshots/*.json  ◄─── h1-scope-watcher writes here
    │  runs scan
    └──────────────────► nuclei binary (built-in)

Die beiden Container teilen sich das gleiche Host-Verzeichnis, das als Volume eingebunden ist. h1-scope-watcher hält die JSON-Dateien auf dem neuesten Stand; nuclei-mcp liest sie nur.

Related MCP server: shodan-mcp

Scope-Gate — Funktionsweise

Jeder Aufruf von nuclei_scan oder check_scope führt diese Logik aus, bevor das Netzwerk kontaktiert wird:

1. Laden aller *.json-Dateien aus /data/snapshots

2. Versuch eines exakten Hostname-Abgleichs (z. B. api.life360.com → passt zu api.life360.com)

3. Versuch eines Platzhalter-Abgleichs (z. B. sub.tile.com → passt zu *.tile.com)

4. Versuch eines Fuzzy-Keyword-Abgleichs (z. B. life360 → findet api.life360.com, api-cloudfront.life360.com)

5. Überprüfung von eligible_for_bounty == true UND eligible_for_submission == true

6. Blockieren, falls eine Prüfung fehlschlägt — keine Ausnahme, keine Umgehung

Schnellstart

1. Image bauen

cd nuclei-mcp
docker build -t nuclei-mcp .

2. Zur Claude/Copilot MCP-Konfiguration hinzufügen

Öffnen Sie claude_desktop_config.json (oder äquivalent) mcp-config.json (Copilot) und fügen Sie Folgendes hinzu:

{
  "mcpServers": {
    "h1-scope-watcher": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "mcp/h1-scope"
      ]
    },
    "nuclei-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-v", "D:/projects/H1-Scope-Watcher/snapshots:/data/snapshots",
        "-e", "SNAPSHOTS_DIR=/data/snapshots",
        "nuclei-mcp"
      ]
    }
  }
}

Wichtiger Punkt: Beide Container binden den exakt gleichen Host-Pfad (D:/projects/H1-Scope-Watcher/snapshots) ein, sodass sie die Scope-Daten ohne zusätzliches Networking oder IPC teilen.

H1-Scope-Watcher

MCP-Tools

nuclei_scan

Führt einen Nuclei-Scan aus — Scope-geschützt.

Beispiel-Prompts:

• "Run nuclei on life360"

• "Scan api.tile.com for critical and high findings"

• "Run nuclei on production.tile-api.com with cve templates only"

check_scope

Vorschau des Scope-Gate-Ergebnisses ohne Scan.

Beispiel-Prompts:

• "Is tile.com in scope?"

• "Check if snipeit.corp.tile.com is bounty eligible" → zeigt BLOCKED

list_programs

Zeigt alle Assets aus allen Snapshot-Dateien, gruppiert nach Berechtigung.

Umgebungsvariablen

Referenz zum Scope-Verhalten

Beispiel vom tile.com-Programm:

Rechtliches

Scannen Sie nur Ziele, die Ihnen gehören oder für die Sie eine ausdrückliche schriftliche Erlaubnis zum Testen haben. Dieses Tool gewährt keine Autorisierung — Ihre HackerOne-Programmvereinbarung ist das Autorisierungsdokument.