🔴 Red Team MCP Server

Ein leistungsstarker Penetration-Testing-MCP-Server, der 20 echte Hacking-Tools in einem Kali-Linux-Docker-Container ausführt und diese direkt mit KI-Assistenten wie Cursor, Claude oder jeder anderen MCP-kompatiblen IDE verbindet.

Anstatt Befehle manuell einzugeben, fragen Sie einfach in natürlicher Sprache:

"Scanne Ports auf 192.168.1.1" "Finde Subdomains von example.com" "Prüfe, ob diese Seite eine SQL-Injection aufweist"

Die KI ruft das richtige Tool auf, führt es in Kali Linux aus und liefert Ihnen die Ergebnisse.

🛠️ Enthaltene Tools (insgesamt 20)

✅ Voraussetzungen

Stellen Sie vor dem Start sicher, dass Folgendes installiert ist:

• Git — https://git-scm.com/downloads

• Docker Desktop — https://www.docker.com/products/docker-desktop (Linux-Container aktivieren)

• Python 3.11 — https://www.python.org/downloads/release/python-3110 (nur lokal erforderlich, wenn Sie den Server bearbeiten möchten; der Container erledigt den Rest)

• Jede MCP-kompatible IDE: Cursor, VS Code + Kiro, Claude Desktop usw.

Hinweis zur Python-Version: Das Projekt ist für Python 3.11+ geschrieben. Der Docker-Container verwendet das in Kali integrierte Python 3 (3.12). Beides funktioniert einwandfrei.

🚀 Installation — Schritt für Schritt

Schritt 1 — Repo klonen

git clone https://github.com/YOUR_USERNAME/redteam-mcp.git
cd redteam-mcp

Schritt 2 — Docker-Image erstellen

Dies lädt Kali Linux herunter und installiert alle 20 Tools. Dies dauert beim ersten Mal 10–20 Minuten.

docker build -t redteam-mcp:latest .

Sie müssen dies nur einmal ausführen (oder wenn Sie das Projekt aktualisieren).

Schritt 3 — Container starten

Windows (PowerShell):

.\run.ps1

Mac / Linux:

bash run.sh

Überprüfen Sie, ob er läuft:

docker ps

Sie sollten redteam-mcp mit dem Status Up sehen.

Schritt 4 — IDE verbinden

Öffnen Sie Ihre MCP-Konfigurationsdatei in Ihrer IDE und fügen Sie dies ein:

{
 "mcpServers": {
 "redteam-kali": {
 "command": "docker",
 "args": [
 "exec", "-i", "redteam-mcp",
 "/app/.venv/bin/python", "/app/src/server.py"
 ],
 "disabled": false,
 "autoApprove": []
 }
 }
}

Wo Sie es einfügen müssen:

Starten Sie nach dem Einfügen Ihr IDE-Fenster neu (Strg+Umschalt+P → Reload Window).

Schritt 5 — Fragen stellen

Sie sind bereit. Geben Sie einfach etwas in natürlicher Sprache ein:

Scan ports on scanme.nmap.org
Find subdomains of tesla.com
Check if http://testphp.vulnweb.com has SQL injection
Detect the WAF on cloudflare.com
Run a nikto scan on http://testphp.vulnweb.com

📋 Anleitung für den täglichen Gebrauch

Projekt starten

.\run.ps1

Starten Sie dann Ihr IDE-Fenster neu.

Stoppen, wenn fertig

docker stop redteam-mcp

Container neu starten

docker restart redteam-mcp

Vollständiges Zurücksetzen (falls etwas kaputt geht)

docker rm -f redteam-mcp
.\run.ps1

Image neu erstellen (nur nach Bearbeitung von Dockerfile oder server.py)

docker rm -f redteam-mcp
docker build -t redteam-mcp:latest .
.\run.ps1

Container-Logs prüfen

docker logs redteam-mcp

Shell innerhalb des Containers öffnen

docker exec -it redteam-mcp /bin/bash

⚠️ Rechtlicher Hinweis

Verwenden Sie diese Tools nur gegen Systeme, die Sie besitzen oder für die Sie eine ausdrückliche schriftliche Genehmigung zum Testen haben. Unbefugtes Scannen ist illegal. Das in den Beispielen verwendete legale Testziel ist scanme.nmap.org (vom nmap-Projekt für diesen Zweck bereitgestellt).

📁 Projektstruktur

redteam-mcp/
├── src/
│ └── server.py # MCP server with all 20 tools
├── Dockerfile # Kali Linux multi-stage build
├── requirements.txt # Python deps (mcp only)
├── run.ps1 # Start container (Windows)
├── run.sh # Start container (Mac/Linux)
└── .kiro/
 └── settings/
 └── mcp.json # IDE MCP config

Resources

• GitHub Repository
Need Help?Related Servers