Englisch · Русский (RU)

🧠 pentool-mcp-server

MCP-Server für Pentool — den lokalen KI-Assistenten für Web-Pentesting

Ein eigenständiger stdio JSON-RPC 2.0-Server, der KI-Fähigkeiten für jeden MCP-Client bereitstellt — in erster Linie für Pentool (BYO-LLM: Auswahl von Checks, Umgehung von WAF, Finden ungewöhnlicher Endpunkte). Installiert mit uv in einem Befehl.

Warum ein separates Paket

MCP ist das offene Protokoll zur Verbindung von LLM-Modellen mit Werkzeugen. pentool-mcp-server kapselt die MCP-Schicht von Pentool als wiederverwendbares PyPI-Paket: lokal angebunden (stdio), kein Netzwerk, keine Ports, installiert in Sekunden, keine schweren Abhängigkeiten.

Related MCP server: pentestMCP

🔗 Für Pentool entwickelt

Dieser Server ist die MCP-Komponente von Pentool, einem professionellen Web-Sicherheitstest-Terminal (Burp-kompatibler Proxy, Scanner, Spider, Intruder — alles in einer TUI). Er versorgt Pentools KI mit:

• 🎯 Auswahl der relevanten Scan-Checks für ein konkretes Ziel;

• 🛡 WAF-Umgehung / Payload-Vorschläge;

• 🕷 Finden von nicht offensichtlichen Endpunkten während des Spider-Crawlings.

Probieren Sie den vollständigen Stack aus: uv tool install "pentool[ai]" → pentool ai setup → pentool.

⚡ Schnellstart (uv)

# Install uv (if not present): https://docs.astral.sh/uv/
curl -LsSf https://astral.sh/uv/install.sh | sh

# Standalone — just the MCP server
uv tool install pentool-mcp-server
pentool-mcp-server --version

# Or together with Pentool and its AI extras
uv tool install "pentool[ai]"

Gesundheitscheck (stdio):

echo '{"jsonrpc":"2.0","id":1,"method":"ping"}' | pentool-mcp-server
# → {"jsonrpc": "2.0", "id": 1, "result": {"status": "ok"}}

uv ist der Standardinstallationspfad — isolierte Umgebung, genau wie Pentool selbst installiert wird. Es hält den Server von Ihrem System-Python fern.

🚀 Bereitstellung auf einem VPS / in einem Container

Der Server öffnet keine Ports und läuft als lokaler Unterprozess — sicher auf jedem Host. Mit uv bleibt er außerhalb des System-Pythons:

uv tool install pentool-mcp-server

Vollständige Benutzeranleitung — docs/GUIDE.md. Russisch — README.ru.

🧩 MCP-Werkzeuge

🔒 Sicherheit

• Kein Netzwerk standardmäßig. pentool-mcp-server hört nur auf stdio (stdin → stdout) innerhalb des lokalen Prozesses. Externer Zugriff ist unmöglich — weder von anderen Prozessen noch von einem anderen Host.

• Nicht über TCP/0.0.0.0 ohne Authentifizierung freigeben. Wenn auf einem Netzwerkport nach außen ausgeführt, erhält jeder, der in stdin/Port schreiben kann, tools/call generate (Ressourcennutzung + Senden von Zieldaten an das LLM). MCP hat keine eingebaute Authentifizierung — binden Sie an 127.0.0.1 und sichern Sie es über eine Firewall.

• Ziel-Privatsphäre. Daten (URL, Payload) verlassen den Host nur, wenn ein externer LLM-Anbieter verbunden ist; bei einem lokalen GGUF-Modell bleibt der Verkehr auf dem Rechner.

Mehr — docs/GUIDE.md.

🗺 Fahrplan

• stdio JSON-RPC 2.0 Server (initialize / tools/list / tools/call / ping)

• generate, health, configure Werkzeuge

• echter LLM-Ausführer (llama-cpp-python) in model.py

• optionaler TCP-Modus mit HMAC-Authentifizierung

📄 Lizenz

AGPL-3.0 — die gleiche Lizenz wie Pentool.

Support / Fehler: issues · Entwickelt für Pentool · Benutzeranleitung