Kitsune Schwachstellenforschung MCP

Dieser lokale MCP-Server speichert Schwachstelleninformationen, Forschungsbereich, Scannerergebnisse, Beweisbelege, Bugcrowd VRT-Bewertungen und Berichtsentwürfe in einem SQLite-Ledger.

Er wurde für autorisierte defensive Forschung gebaut. Er scannt keine Ziele, führt keine Exploits aus, führt keine Shell-Befehle aus, reicht keine Berichte ein und veröffentlicht keine Offenlegungen.

Datenquellen

Der Server verwendet feste Adapter. Ein Aufrufer kann keine andere Quelle angeben.

CVE.org ist der kanonische Datensatz. NVD ist Anreicherung und Entdeckung aktueller Datensätze. KEV und EPSS sind separate Signale. VRT ist eine technische Baseline, keine Autorisierung oder garantierte Bounty-Bewertung.

Related MCP server: MoonMCP

Anforderungen

• Node.js 24 oder neuer

• npm 10 oder neuer

• Ein absoluter Import-Root, wenn SARIF- oder Beweisdateien importiert werden sollen

Für die öffentlichen Feeds ist kein API-Schlüssel erforderlich. NVD_API_KEY ist optional und wird nur an NVD gesendet.

Installieren und verifizieren

npm install
npm test
npm run check
npm run lint
npm run build

Der Quellcode ist unter der MIT-Lizenz verfügbar. Das Paket ist nicht auf npm veröffentlicht.

MCP-Client-Konfiguration

Zuerst bauen, dann den Client auf den kompilierten stdio-Einstiegspunkt verweisen:

{
  "mcpServers": {
    "kitsune-vuln-research": {
      "command": "node",
      "args": [
        "--disable-warning=ExperimentalWarning",
        "C:\\path\\to\\kitsune-vuln-research-mcp\\dist\\index.js"
      ],
      "env": {
        "VULN_IMPORT_ROOTS": "C:\\absolute\\path\\to\\scanner-output",
        "VULN_LOG_LEVEL": "warn"
      }
    }
  }
}

Lizenz

MIT. Siehe LICENSE.

Das eingebaute Node SQLite-Modul trägt in Node 24 noch eine ExperimentalWarning. Das enge Befehlszeilen-Flag hält diese Warnung aus MCP stderr heraus, ohne andere Warnungsklassen zu unterdrücken.

Konfiguration

Der Laufzeitzustand wird unter VULN_DATA_DIR gespeichert:

vuln-research.sqlite
cases/
  <case-id>/
    evidence/
    exports/

SQLite verwendet Fremdschlüssel, WAL-Modus, vorbereitete Anweisungen und Append-Only-Ereignisbelege. Quell-Payloads und Beweise werden SHA-256-gehasht.

Intelligence-Tools

Die Kandidatenordnung ist Forschungspriorität. Sie ersetzt nicht CVSS, VRT, reproduzierten Einfluss oder Programmregeln.

Forschungswerkzeuge

Das Registrieren eines Bereichs hier erzeugt keine Berechtigung. authorization_ref muss auf die echte Bounty-Briefing, den Vertrag, das Ticket oder die Laborautorisierung verweisen.

Normaler Arbeitsablauf

1. Setzen Sie VULN_IMPORT_ROOTS auf das Scanner-Ausgabeverzeichnis.

2. Aktualisieren Sie aktuelle CVEs, KEV, EPSS und VRT.

3. Registrieren Sie den echten Programmbereich und das Gültigkeitsfenster.

4. Erstellen Sie einen Fall für genau ein Ziel und eine zulässige Methode.

5. Führen Sie Semgrep, CodeQL, Trivy, Grype oder einen anderen genehmigten Scanner außerhalb dieses MCP aus.

6. Importieren Sie seine SARIF-Ausgabe und erfassen Sie Reproduktionsnachweise.

7. Wählen Sie einen terminalen VRT-Pfad und erfassen Sie die tatsächliche Auswirkung.

8. Exportieren Sie einen lokalen Entwurf zur menschlichen Überprüfung.

Scanner-Nachrichten und Beratungstexte werden als nicht vertrauenswürdige Daten behandelt. Sie können Bereich, Toolauswahl, SQL, Pfade oder Berichtsstruktur nicht ändern.

Importsicherheit

• Import-Roots müssen absolut und explizit konfiguriert sein.

• Kanonische Pfade müssen innerhalb eines erlaubten Roots bleiben.

• Symbolische Link-Importe, Windows-Gerätepfade und alternative Datenströme werden abgelehnt.

• Dateien sind standardmäßig auf 25 MiB begrenzt.

• Gespeicherte Beweisnamen werden vom Server generiert.

• Doppelte Beweise und SARIF-Ergebnisse werden durch Hashes oder stabile Fingerabdrücke identifiziert.

Veraltete Feeds und Offline-Arbeit

Rufen Sie vuln_get_source_status auf, bevor Sie zwischengespeicherte Informationen verwenden. NVD, KEV, EPSS und VRT sind nach 24 Stunden veraltet. Kanonischer CVE- und OSV-Abfragezustand sind nach sieben Tagen veraltet.

Wenn eine Quelle nicht verfügbar ist, bleibt der letzte gute Cache lesbar. Setzen Sie VULN_OFFLINE=true, wenn eine Sitzung keine Netzwerkanfragen stellen darf.

Tests

Die Suite verwendet standardmäßig aufgezeichnete Fixtures. Sie deckt Schemata, Quellbeschränkungen, Ursprungsisolierung, Bereichsabgleich, Pfadeinhaltung, SARIF-Prompt-Injection-Zeichenfolgen, Beweishashing, VRT-Bewertung, Berichts-Escaping, MCP-Erkennung und Neustartpersistenz ab.

evaluation.xml enthält zehn stabile, schreibgeschützte Fragen basierend auf den festen 2026-Fixtures unter tests/fixtures.

Erstellen und seeden Sie diese Fixtures in ein neues absolutes Datenverzeichnis, bevor Sie die Evaluierungen ausführen:

npm run seed:evaluation -- C:\absolute\unused\evaluation-data

Der Seeder weigert sich, eine vorhandene Datenbank zu überschreiben. Verweisen Sie VULN_DATA_DIR auf dieses Verzeichnis, wenn Sie den Evaluierungsserver starten.