Claude Kali MCP-Kommandant

Claude Kali MCP-Integration

Eine saubere, minimale Implementierung der Kali Linux MCP-Integration (Model Context Protocol) für Claude Desktop. Sie bietet sicheren Zugriff auf Kali Linux-Tools über Claudes Benutzeroberfläche. Dieses Projekt ermöglicht die nahtlose Ausführung von Sicherheitstools und -befehlen in einem isolierten Docker-Container.

Merkmale

🐳 Docker-basiert – Containerisierte Umgebung für konsistente Ausführung
🔒 Isolierte Umgebung – Kali Linux-Tools in einer sicheren Sandbox
🔄 Automatische Integritätsprüfungen – Gewährleistet die Zuverlässigkeit und Verfügbarkeit des Dienstes
📡 MCP-Server – Standardprotokollintegration mit Claude Desktop
🚀 Schnelle Einrichtung – Beginnen Sie mit minimaler Konfiguration
🔧 Konfigurierbar – Anpassbare Ports und Einstellungen
🔍 Security-First – Isolierte Ausführungsumgebung für Sicherheitstools
📊 Überwachung – Integrierte Integritätsprüfungen und Statusendpunkte

Voraussetzungen

Docker (v20.10.0+)
Docker Compose (v2.0.0+)
Git (zum Klonen des Repository)
Node.js (v16+ für Entwicklung und Tests)

Netzwerkhinweis

Standardmäßig verwenden die bereitgestellten Dateien docker-compose.yml und docker-compose.full.yml das Host-Netzwerk ( network_mode: host ). Dadurch erhalten die Container vollen Zugriff auf das Host-Netzwerk, was für einige erweiterte Netzwerktools und -szenarien erforderlich ist.

Sicherheitshinweis:

Host-Netzwerke sorgen für weniger Isolation zwischen Ihrem Host und den Containern. Alle Netzwerkschnittstellen und Ports werden gemeinsam genutzt.
Wenn Sie mehr Isolation wünschen, können Sie zum Standard bridge -Netzwerk von Docker wechseln, indem Sie die Zeilen network_mode: host entfernen und den entsprechenden Diensten eine ports: -Zuordnung (z. B. 8081:8080 ) hinzufügen. Weitere Informationen finden Sie in den kommentierten Beispielen in den Compose-Dateien und der Dokumentation weiter unten.

Schnellstart

Klonen Sie das Repository :
git clone https://github.com/house-of-stark/Claude-Kali-MCP-Commander cd Claude-Kali-MCP-Commander

🛠️ Build & Run-Anweisungen

Hinweis: sudo ist im Kali-Container für Tools wie nmap und andere aktiviert, die erhöhte Berechtigungen erfordern. Wenn Sie die Verwendung von sudo einschränken möchten, bearbeiten Sie die Liste blockedCommands “ in config.json .

Windows (PowerShell)

Hinweis: Wenn ein Fehler bei der Skriptsignatur oder der Ausführungsrichtlinie auftritt, führen Sie das Skript mit ExecutionPolicy Bypass aus:

Minimaler Build (empfohlen):
powershell -ExecutionPolicy Bypass -File .\build.ps1 docker-compose up -d
Vollständiger Kali-Tool-Build:
powershell -ExecutionPolicy Bypass -File .\build.ps1 -Profile full docker-compose -f docker-compose.full.yml up -d

Linux / macOS (Bash)

Minimaler Build (empfohlen):
./build.sh minimal docker-compose up -d
Vollständiger Kali-Tool-Build:
./build.sh full docker-compose -f docker-compose.full.yml up -d

Dienste starten und überwachen

Schnellstartskript (Linux/macOS):
chmod +x start.sh ./start.sh
Dadurch werden die Container erstellt und gestartet, auf die Bereitschaft gewartet und der Status angezeigt.
Endpunkt „Integrität prüfen“:
curl http://localhost:8080/health
Sollte zurückgeben: {"status":"ok"}
Laufende Container anzeigen:
docker ps --filter "name=kali-mcp-commander"

Claude Desktop konfigurieren

Legen Sie die MCP-Server-URL fest auf: http://localhost:8080
(Optional) Legen Sie den Projektpfad auf Ihr lokales Repo-Verzeichnis fest

Wählen Sie Ihr Build-Profil :
- Minimal (Standard) : Kleines Bild mit nur dem MCP-Server (für die meisten Benutzer empfohlen)
  ./build.sh minimal docker-compose up -d
- Vollständig : Komplettes Kali Linux mit allen Tools (sehr großes Bild)
  ./build.sh full docker-compose -f docker-compose.full.yml up -d
Der minimale Build ist viel schneller und kleiner, während der vollständige Build alle Kali Linux-Tools enthält, aber viel Speicherplatz benötigt.
Überprüfen Sie die Installation :
curl http://localhost:8081/health
Sollte zurückgeben: {"status":"ok"}
Konfigurieren Sie Claude Desktop :
- Öffnen Sie die Claude Desktop-Einstellungen
- Legen Sie die MCP-Server-URL fest auf: http://localhost:8081
- Legen Sie den Projektpfad auf den vollständigen Pfad dieses Repositorys fest (z. B. /path/to/Claude-Kali-MCP-Commander ).
- Starten Sie Claude Desktop neu

Projektstruktur

.
├── .gitignore           # Git ignore file
├── CONTRIBUTING.md      # Contribution guidelines
├── Dockerfile           # Kali Linux container setup with MCP server
├── LICENSE              # MIT License
├── README.md            # This file
├── config/              # Configuration files
│   └── claude_desktop_config.json  # Claude Desktop configuration
├── docker-compose.yml   # Service definitions and orchestration
├── health-server.js     # Health check server implementation
├── package.json         # Node.js dependencies
└── start.sh             # Helper script to start services

Testen der Integration

Nach dem Starten der Dienste können Sie die MCP-Integration testen:

Grundlegender Integritätscheck : (Bei Verwendung einer Überbrückung zu Docker)
curl http://localhost:8081/health
Sollte zurückgeben: {"status":"ok"}
Containerstatus überprüfen :
docker ps --filter "name=kali-mcp-commander-minimal"
Sollte den Container als „gesund“ anzeigen
Containerprotokolle anzeigen :
docker logs kali-mcp-commander
Überprüfen Sie, ob Fehlermeldungen oder Warnungen vorliegen

Konfiguration

Claude Desktop-Konfiguration

Um diesen MCP-Server mit Claude Desktop zu verwenden, müssen Sie in Ihren Claude Desktop-Einstellungen Folgendes konfigurieren:

Kali Linux MCP (Erforderlich) : Führt Befehle im Docker-Container mit Kali Linux-Tools aus
Host OS Commander (optional) : Ermöglicht die Ausführung von Befehlen direkt auf dem Host-Betriebssystem, auf dem Claude Desktop installiert ist. Sie können diesen Abschnitt entfernen, wenn Sie nur die Kali Linux-Umgebung benötigen.

Beispiel für einen einzelnen MCP-Server claude_desktop_config.json :

{
  "mcpServers": {
    "kali-mcp": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "kali-mcp-commander-minimal",
        "npx",
        "@wonderwhy-er/desktop-commander"
      ],
      "name": "Kali Linux MCP",
      "description": "Access Kali Linux security tools via MCP"
    }
  },
  "defaultMcpServerId": "kali-mcp"
}

Beispiel für MCP Commander Desktop OS und Kali MCP Server claude_desktop_config.json :

{
  "mcpServers": {
    "kali-mcp": {
      "command": "docker",
      "args": [
        "exec",
        "-i",
        "kali-mcp-commander-minimal",
        "npx",
        "@wonderwhy-er/desktop-commander"
      ],
      "name": "Kali Linux MCP",
      "description": "Access Kali Linux security tools via MCP"
    },
    "desktop-commander": {
      "command": "npx",
      "args": [
        "@wonderwhy-er/desktop-commander@latest"
      ],
      "name": "Host OS Commander",
      "description": "Access commands on the host OS where Claude Desktop is installed"
    }
  },
  "defaultMcpServerId": "kali-mcp"
}

Umgebungsvariablen

Sie können die folgenden Umgebungsvariablen in der Datei docker-compose.yml anpassen:

MCP_SERVER_PORT : Port für den MCP-Server (Standard: 8080)
NODE_ENV : Umgebungsmodus (Entwicklung/Produktion)
LOG_LEVEL : Ausführlichkeit der Protokollierung (Debug, Info, Warnung, Fehler)

Portkonfiguration (wenn kein Host-Netzwerk verwendet wird)

Um die Standardports zu ändern, bearbeiten Sie den Abschnitt ports in docker-compose.yml :

ports:
  - "8081:8080"  # HostPort:ContainerPort

Fehlerbehebung

Häufige Probleme

Portkonflikte
- Symptom : Container kann aufgrund von Port-Bindungsfehlern nicht gestartet werden
- Lösung : Ändern Sie den Host-Port in docker-compose.yml
Container-Integritätsprüfung schlägt fehl
- Symptom : Container wird ständig neu gestartet
- Lösung : Überprüfen Sie die Protokolle mit docker logs kali-mcp-commander-minimal
MCP-Server antwortet nicht
- Symptom : Claude Desktop kann keine Verbindung zum MCP-Server herstellen
- Lösung :
  - Überprüfen Sie, ob der Server ausgeführt wird: curl http://localhost:8081/health
  - Überprüfen Sie die Docker-Netzwerkeinstellungen
  - Stellen Sie sicher, dass keine Firewall Port 8081 blockiert.

Debuggen

Für eine detaillierte Fehlerbehebung können Sie docker-compose.yml ändern, um zusätzliche Protokollierung einzuschließen:

environment:
  - NODE_ENV=development
  - DEBUG=*

Sicherheitsüberlegungen

Der Container läuft mit minimalen Berechtigungen
Der Netzwerkzugriff ist standardmäßig auf localhost beschränkt
Für das Basisimage von Kali Linux werden regelmäßige Sicherheitsupdates empfohlen.
Überprüfen Sie die Docker-Datei auf benutzerdefinierte Konfigurationen

Leistung

Der Container ist für minimalen Ressourcenverbrauch optimiert
Gesundheitschecks sichern die Serviceverfügbarkeit
Ressourcenlimits können in docker-compose.yml konfiguriert werden

Beitragen

Beiträge sind willkommen! Bitte lesen Sie unsere Beitragsrichtlinien, um zu erfahren, wie Sie zu diesem Projekt beitragen können.

Bitte beachten Sie bei Ihrem Beitrag:

Forken Sie das Repository
Erstellen eines Feature-Zweigs
Übernehmen Sie Ihre Änderungen
Push zum Zweig
Erstellen Sie einen neuen Pull Request

Lizenz

Dieses Projekt ist unter der MIT-Lizenz lizenziert – Einzelheiten finden Sie in der Datei LICENSE .

Credits

Originalwerk von Eduard Ruzga (2024)

Unterstützung

Für Support öffnen Sie bitte ein Problem auf GitHub.

Claude Kali MCP Commander

Integrations