Nicht für Bildungszwecke: Ein MCP-Server für professionelle Penetrationstester mit STDIO/HTTP/SSE-Unterstützung, nmap, go/dirbuster, nikto, JtR, hashcat, Wörterlistenerstellung und mehr.
Pentest MCP ist ein TypeScript-MCP-Server für autorisierte Sicherheitsbewertungen. Er bietet einem menschlichen Forscher oder einem werkzeugnutzenden Bewertungsagenten eine einzige abgegrenzte Schnittstelle für Discovery, Validierung, Erfassung, Anmeldedatenprüfungen, lokale Audits, Beweismittelabruf und Berichtsvorbereitung. Jeder aktive Werkzeugaufruf ist an ein Engagement und einen dauerhaften Datensatz gebunden. Der Server prüft die deklarierten Ziele und das Zeitfenster; der Forscher verifiziert die Ergebnisse vor der Veröffentlichung.
engagementId.allowedToolNames-Liste des Plans nur ausgewählte Aufrufe erlaubt. Aktive Werkzeuge durchlaufen außerdem das Ziel- und Zeit-Gate des Engagements.recordId-Werte und korrelierte Scope-Entscheidungen mit listEngagementRecords und getEngagementRecord. Datensätze bleiben über Neustarts hinweg erhalten. Importieren Sie externe Recherche mit recordResearchActivity; der Import ersetzt nicht die Nutzung der MCP-Werkzeuge.getClientReport ab.Die Prüfung der deklarierten Ziele ist eine operative Schutzmaßnahme, keine vollständige Netzwerkgrenze. DNS-Änderungen, Weiterleitungen, Nmap-Skripte, Nuclei-Templates und das Verhalten anderer Drittanbieter-Werkzeuge können sekundären Datenverkehr erzeugen. Überprüfen Sie die Werkzeugkonfiguration und halten Sie die Netzwerkkontrollen im Einklang mit den Regeln des Engagements.
Die Bewertungsphase ist eine werkzeugnutzende Agentensitzung. runAgentAssessment unterstützt lokales Codex oder Claude in einem dedizierten Kontoprofil, Codex in einem gepinnten Container, einen Loopback-OpenAI-kompatiblen Server wie llama.cpp oder Ollama sowie OpenRouter. CLI-Worker erhalten einen gesperrten Pentest-MCP-Server für ein einziges Engagement und entdecken den vollständigen Katalog. Abgesicherte API-Modelle erhalten nur die exakte Plan-Allowlist, geschnitten mit dem Worker-Katalog. Jede angeforderte Aktion durchläuft weiterhin dieselben worker-seitigen Plan-, Ziel-, Parent-Status- und Zeitprüfungen, bevor ein Handler startet. Das optionale hostileModelProtection fügt Schutzschalter für doppelte Aktionen, Token-Abrechnung und Finish-Reason hinzu und ist standardmäßig auf false gesetzt. Ein unterbrochener Lauf mit einem dauerhaften Start-Beleg und ohne Abschluss-Beleg blockiert die Wiederholung; reconcileAgentAssessment erfordert, dass ein Operator bestätigt, dass der vorherige Prozess beendet wurde, zeichnet Prüfer und Begründung auf und widerruft den vorherigen Worker-Scope, sofern dieser noch verfügbar ist. Die zurückgegebenen toolCounts, importedRecordIds und importMapRecordId identifizieren aufgezeichnete Aktionen und importierte Beweismittel. Ein Lauf ohne erfolgreichen Aufruf eines Bewertungswerkzeugs schlägt fehl.
draftAssessmentReport ist ein späterer, kontextisolierter Schritt zur Berichtserstellung; ein Entwurf allein belegt nicht, dass Pentest MCP die Bewertung unterstützt hat. OpenAI, Anthropic, OpenRouter, OpenAI-kompatible, lokale Codex-, lokale Claude-, Container-Codex- und konfigurierte SSH-Profile können aus einem begrenzten Evidenzpaket ohne Scanner-Tools einen Entwurf erstellen. local-agent akzeptiert selbst gehostete CLI-Profile und Loopback-OpenAI-kompatible Profile und lehnt gehostete Anbieter ab, bevor der Kontext gesendet wird. Der Leitfaden für abgesicherte Modelle enthält llama.cpp- und OpenRouter-Profile, erzwungene Abbruchbedingungen, Audit-Felder und Bereitstellungsgrenzen für feindselige Modelle. Der Leitfaden zur Container-Bewertung enthält CLI-Profilfelder, den realen Abnahmebefehl und Isolationsgrenzen. Der agentische Workflow behandelt Geltungsbereich, Evidenzprüfung, Daybreak/Glasswing-Zugriff und Faxbot-Planung.
Die Release-Abnahme verwendet scripts/run-real-acceptance.mjs. Es gibt kein Standardziel und keine Standardautorisierung und der Vorgang wird abgelehnt, sofern nicht installiertes Nmap und ProjectDiscovery HTTPX erfolgreiche Evidenzdatensätze erzeugen. Mit --profile muss der verwaltete Agent beide über Pentest MCP aufrufen. Mit --report-profile muss ein separater Berichtskontext den gespeicherten Entwurf erzeugen. Test-Doubles verbleiben ausschließlich in automatisierten Tests und werden niemals als Abnahmebelege ausgeliefert.
Erfordert Node.js 22.19.0 oder neuer sowie die Host-Binärdateien für die Tools, die Sie verwenden möchten. Das Docker-Image enthält die aufgeführten Tools; native Installationen müssen sie in PATH bereitstellen.
npm install -g pentest-mcp
pentest-mcp
Stdio ist der Standard für lokale MCP-Clients. pentest-mcp inspector startet den mitgelieferten MCP Inspector gegen diesen Server über stdio; Inspector-Flags können weitergegeben werden, zum Beispiel pentest-mcp inspector --help.
Setzen Sie PENTEST_DATA_DIR, um das lokale Evidenzverzeichnis zu wählen. Andernfalls verwendet der Server $XDG_DATA_HOME/pentest-mcp, wenn diese Variable gesetzt ist, oder ~/.pentest-mcp. Evidenz- und Berichtsdateien werden mit privaten Verzeichnis- und Dateiberechtigungen gespeichert. Behandeln Sie Rohausgaben, Hashes, aufgezeichneten Datenverkehr und Berichte als clientvertrauliche Daten; steuern Sie Zugriff, Aufbewahrung und Backups entsprechend.
Rufen Sie createEngagement vor dem Scannen auf. Verwenden Sie Daten, Ziele und Referenzen aus der tatsächlich unterzeichneten Autorisierung; die untenstehenden Werte sind illustrativ.
{
"tool": "createEngagement",
"arguments": {
"engagementId": "client-2026-10",
"authorizationReference": "Signed SoW section 4, approved 2026-10-24",
"notBefore": "2026-10-25T09:00:00-06:00",
"expiresAt": "2026-10-26T18:00:00-06:00",
"allowedTargets": ["app.example.com", "192.0.2.0/28"],
"excludedTargets": ["192.0.2.7"],
"testingWindows": [
{
"start": "2026-10-25T09:00:00-06:00",
"end": "2026-10-25T17:00:00-06:00"
}
]
}
}
Erlaubte Ziele akzeptieren exakte Hosts, CIDRs, Wildcard-Subdomains und HTTP(S)-URL-Präfixe. Ausschlüsse haben Vorrang. Alle Zeitstempel benötigen eine explizite Zeitzone. getEngagement und listEngagements inspizieren gespeicherte Registrierungen. closeEngagement widerruft die spätere Ausführung, bricht verwaltete Assessments ab, die im selben Serverprozess laufen, und bewirkt, dass ein separater verwalteter Runner stoppt, wenn er die Schließung der übergeordneten Registrierung beobachtet.