🔴 RedTeam MCP — Kali Linux Security Assistant & Agentic Server

Ein LLM-gesteuerter Model Context Protocol (MCP)-Server, der KI-Assistenten und IDEs (Cursor, Claude Desktop, VS Code, Kiro, Antigravity) mit einer Suite von 42 Kali Linux- & Bug-Bounty-Sicherheitstools verbindet, die in einem Container laufen.

Er unterstützt sowohl direkte Tool-Aufrufe (z. B. "Führe einen nmap-Scan auf scanme.nmap.org aus") als auch autonome mehrstufige Pentests, die von lokalen Ollama-Modellen unterstützt werden (pentest_target).

🛠️ Enthaltene Tools & Fähigkeiten (42 MCP-Tools)

1. Netzwerk-Recon & Port-Scanning

• nmap_scan: Detailliertes Service- und Skript-Port-Scanning.

• rustscan: Ultraschnelle Port-Erkennung, die an Nmap weitergeleitet wird.

• naabu_scan: Schneller SYN-basierter Port-Scanner, ideal als erster Durchgang vor nmap bei großen Bereichen.

2. OSINT, DNS & Subdomain-Enumeration

• subfinder_enum: Passive Subdomain-Erkennung.

• amass_enum: Detaillierte DNS-Enumeration & Kartierung der Angriffsfläche.

• dnsrecon_enum: DNS-Record-Reconnaissance.

• dnsx_resolve: Schnelle Bulk-DNS-Auflösung & Filterung von Subdomain-Listen.

• alterx_permute: Wortlistenbasierte Subdomain-Permutation zum Auffinden nicht offensichtlicher Hosts.

• asnmap_lookup: Ordnet eine Domain/Organisation ihrer ASN und den zugehörigen IP-Bereichen zu.

• uncover_search: Durchsucht Shodan/Censys/Fofa-ähnliche Suchmaschinen nach exponierten Hosts.

• theharvester_osint: Öffentliche E-Mail-, IP- und Domain-Erfassung.

• httpx_probe: Live-HTTP-Service-Probing, Statuscodes, Titel, Technologie-Erkennung.

3. Web-Schwachstellen- & Technologieanalyse

• nikto_scan: Webserver-Schwachstellen-Audit.

• nuclei_scan: Vorlagenbasiertes Schwachstellen-Scanner (CVEs, Exposures, Fehlkonfigurationen).

• whatweb_scan: Web-Technologie- & CMS-Fingerprinting.

• sslscan_audit: SSL/TLS-Cipher- & Zertifikatsprüfung.

• wpscan_scan: WordPress-Plugin-, Theme- und Benutzer-Enumeration.

4. Content-Discovery, Crawling & URL-Mining

• gobuster_dir: Verzeichnis- & Datei-Brute-Forcing.

• ffuf_fuzz: Endpunkt-, Parameter- und Header-Fuzzing.

• feroxbuster: Rekursive Web-Content-Erkennung.

• arjun_params: Erkennung versteckter HTTP-Parameter.

• katana_crawl: Moderner JS-bewusster Crawler zum Auffinden echter, verlinkter Endpunkte.

• gau_urls: Ruft bekannte URLs für eine Domain von Wayback Machine, Common Crawl & OTX ab.

• waybackurls_fetch: Ruft archivierte historische URLs von der Wayback Machine ab.

5. Schwachstellen-Exploitation & Injection-Tests

• sqlmap_scan: Automatisierte SQL-Injection-Erkennung & -Tests.

• commix_scan: OS-Command-Injection-Tests.

• dalfox_xss: Automatisiertes Reflected/DOM-XSS-Scanning und Parameter-Mining.

• hydra_brute: Multi-Protokoll-Credential-Brute-Forcing.

• kerbrute: Active-Directory-Kerberos-Benutzer-Enumeration.

• msf_auxiliary: Nicht-interaktiver Metasploit-Modul-Runner.

6. Subdomain-Takeover, Secrets & visuelles Recon

• subzy_takeover: Erkennt kaperbare/verwaiste Subdomains, die auf nicht beanspruchte Dienste zeigen.

• gitleaks_scan: Scannt nach hartcodierten Secrets, API-Keys und Zugangsdaten.

• gowitness_screenshot: Massen-Screenshots von Live-Web-Zielen für schnelle visuelle Triage.

7. Out-of-Band-Schwachstellenerkennung

• interactsh_oob: Blind/OOB-Interaktionserkennung für SSRF, XXE und blindes RCE über eine eindeutige Callback-Domain.

8. Benutzerdefinierte Anfragen

• curl_request: Benutzerdefinierte rohe HTTP-Anfrageausführung (Header, Methoden, Body, TLS-Verifizierungs-Umschalter).

9. CVE-Intelligenz & Datenbank

• cve_stats: Metriken der lokalen CVE-Datenbank anzeigen.

10. Agentisches autonomes Pentesting & Gedächtnis

• pentest_target: Autonome mehrstufige Sicherheitsziel-Planungsschleife in einfachem Englisch (Ollama).

• generate_report: Autonome Tests + Markdown/HTML-Berichtserstellung.

• export_report: Speichert Penetrationstest-Berichte direkt in /app/reports/.

• search_findings: Durchsucht den SQLite-Verlauf früherer Scan-Ergebnisse.

• get_attack_surface: Aggregierte Ziel-Intelligenz-Abfrage.

• list_sessions: Sitzungsverlauf & Audit-Trail.

Related MCP server: Zebbern Kali MCP

💻 RedTeam MCP mit Claude Desktop verbinden (Windows)

Sie können RedTeam MCP direkt mit Claude Desktop unter Windows verbinden, sodass Claude alle Kali-Tools direkt im Gespräch verwenden kann.

Schritt-für-Schritt-Konfigurationsanleitung:

1. Öffnen Sie die Claude-Desktop-Einstellungen:

   • Starten Sie Claude Desktop.

   • Klicken Sie auf Ihr Profil/Symbol oder öffnen Sie Einstellungen.

   • Klicken Sie im linken Menü auf Entwickler.

   • Klicken Sie auf Konfiguration bearbeiten (dies öffnet claude_desktop_config.json in Ihrem Standard-Texteditor).

   (Alternativ öffnen Sie %APPDATA%\Claude\claude_desktop_config.json in Notepad oder im Datei-Explorer).

2. Fügen Sie die MCP-Server-Konfiguration ein: Fügen Sie den redteam-kali-Servereintrag zu Ihrer JSON-Datei hinzu:

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

3. Speichern & neu starten:

   • Speichern Sie claude_desktop_config.json.

   • Schließen und starten Sie Claude Desktop vollständig neu.

   • Sie sehen ein Hammer/Werkzeug-Symbol, das anzeigt, dass die redteam-kali-Tools verbunden sind!

⚙️ Verbindung zu anderen IDEs

Konfigurations-JSON-Block für alle IDEs:

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

🚀 Schnellstart-Anleitung

1. Docker-Image erstellen

docker build -t redteam-mcp:latest .

2. Container starten

Windows (PowerShell):

.\run.ps1

Linux / macOS:

bash run.sh

3. Container-Status überprüfen

docker ps

Der Container redteam-mcp zeigt den Status Up an.

4. Server-Ausführung testen (PowerShell-Helfer)

.\mcp-helper-fixed.ps1 "nmap scan scanme.nmap.org"

🏗️ Architektur & Module

redteam-mcp/
├── Dockerfile                  # Kali Linux Docker runtime image
├── requirements.txt            # FastMCP, Ollama SDK, Pydantic, HTTPX, AIOSQLite, Jinja2
├── run.ps1 / run.sh            # Container launch scripts
├── mcp_config.json             # Root IDE MCP configuration template
└── src/
    ├── server.py               # Main MCP Server entry point (42 tools registered)
    ├── agent/                  # PentestAgent Ollama loop & reasoning prompts
    ├── tools/                  # Shell executor, output formatter, tool registry
    ├── parsers/                # Typed Pydantic parsers (Nmap, Nuclei, Nikto, WhatWeb, etc.)
    ├── memory/                 # SQLite store & NVD CVE cross-reference engine
    ├── reporting/              # Markdown & HTML report generators
    └── security/               # Target allowlist, sliding-window rate limiter, JSONL audit logger

🛡️ Sicherheits- & Zielkontrollen

Der Server enthält integrierte Sicherheitskontrollen, die über Umgebungsvariablen konfiguriert werden:

• REDTEAM_ALLOWED_TARGETS: Kommagetrennte Liste von IP-Adressen, CIDR-Bereichen oder Domains, die für Scans erlaubt sind. (Leer lassen für offene Lab-Tests).

• REDTEAM_RATE_LIMIT: Gleitendes Fenster für Tool-Aufruf-Ratenbegrenzung pro Minute (Standard: 0 / unbegrenzt).

• REDTEAM_AUDIT_LOG: Pfad zum Append-only-Audit-Log (/app/data/audit.log).

📋 Änderungshinweis (v2-Dokument-Sync)

Verglichen mit der aktuell registrierten Tool-Liste zum Zeitpunkt dieses Updates:

• Zur Dokumentation hinzugefügt (waren live, aber undokumentiert): naabu_scan, dnsx_resolve, alterx_permute, asnmap_lookup, uncover_search, katana_crawl, gau_urls, waybackurls_fetch, dalfox_xss, subzy_takeover, gitleaks_scan, gowitness_screenshot, interactsh_oob

• Dokumentiert, aber derzeit nicht live — bestätigen Sie, ob dies beabsichtigt ist: wafw00f_detect, find_cves, sync_cve_db

⚠️ Rechtlicher Hinweis

Stellen Sie immer sicher, dass Sie explizite schriftliche Genehmigung haben, bevor Sie Sicherheitsbewertungen an einem Host, einer Anwendung oder einem Netzwerk durchführen. Das Scannen von Zielen ohne Erlaubnis ist illegal.