mcp-kali-tools

Ein Docker-Image, das einen Model Context Protocol-Server ausführt, der gängige Kali-Linux-Pentesting-Tools einem MCP-Client (z. B. Claude Desktop) bereitstellt. Jedes Tool läuft als eigener MCP-Toolaufruf, der direkt als argv ausgeführt wird (ohne Shell), sodass Argumente nicht zum Verketten oder Injizieren beliebiger Shell-Befehle verwendet werden können – aber jedes Tool hat weiterhin die volle Leistungsfähigkeit seines zugrunde liegenden Binärprogramms.

Nur für autorisierte Nutzung. Dies bündelt offensive Sicherheitswerkzeuge (nmap, sqlmap, hydra, Metasploit usw.). Richten Sie es nur an Systemen und Netzwerken aus, für die Sie autorisiert sind, Tests durchzuführen.

Enthaltene Tools

nmap, sqlmap, nikto, hydra, john, hashcat, msfconsole, gobuster, ffuf, whatweb, wpscan, aircrack-ng, searchsploit

aircrack-ng kann vorhandene Capture-Dateien knacken, aber Live-Wireless-Capture (Monitor-Modus) benötigt einen physischen Adapter, der an den Container durchgereicht wird (--device, --net=host), was standardmäßig nicht eingerichtet ist.

Related MCP server: Kali MCP Server

Build

docker build -t mcp-kali-tools:latest .

Manuell ausführen (zum Testen)

Der Server spricht MCP über stdio – er ist nicht dafür gedacht, dauerhaft eigenständig zu laufen. Zum Rauchen-Test können Sie JSON-RPC-Anfragen direkt hineinleiten:

docker run -i --rm mcp-kali-tools:latest

In Claude Desktop konfigurieren

Erstellen Sie ein Host-Verzeichnis für Wortlisten/Scan-Ausgaben, damit diese über Läufe hinweg erhalten bleiben, z. B.:

mkdir -p ~/mcp-data

Fügen Sie dies zu mcpServers in Ihrer claude_desktop_config.json hinzu:

{
  "mcpServers": {
    "kali-tools": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "--cap-add=NET_RAW", "--cap-add=NET_ADMIN",
        "-v", "/home/YOUR_USER/mcp-data:/data",
        "mcp-kali-tools:latest"
      ]
    }
  }
}

--cap-add=NET_RAW --cap-add=NET_ADMIN ist für die vollständige nmap-Funktionalität (z. B. SYN-Scans) erforderlich. Der Mount /data ist der Ort, an dem Wortlisten (z. B. rockyou.txt) und Scan-Ausgaben gespeichert werden sollten – übergeben Sie Pfade unter /data/... in Tool-Argumenten, um dort zu lesen/schreiben.

Starten Sie Claude Desktop nach dem Bearbeiten der Konfiguration neu. Wenn Docker installiert wurde oder Ihr Benutzer gerade zur docker-Gruppe hinzugefügt wurde, melden Sie sich zuerst ab und wieder an – die Gruppenmitgliedschaft gilt nur für neue Anmeldesitzungen.

Hinweise

• Jeder Containerlauf ist ephemer (--rm); nichts bleibt erhalten außer dem, was in /data geschrieben wird.

• Die Ausgabe pro Toolaufruf ist auf 20.000 Zeichen begrenzt und jeder Aufruf hat standardmäßig ein Timeout von 180 s (überschreibbar mit dem Argument timeout bei jedem Toolaufruf).