blackarch-AI

Ein bereichsgesteuerter MCP-Server und eine Reihe von Claude Code Skills für Red-Team- und Blue-Team-Sicherheitsworkflows auf BlackArch Linux.

Was das ist

• MCP-Server (src/blackarch_ai_mcp/) — kapselt lokale Sicherheitstools (nmap, gobuster, nikto, hydra, plus lokale Blue-Team-Audits) als MCP-Werkzeuge, sodass jeder MCP-kompatible Client sie aufrufen kann.

• Claude Code Skills (.claude/skills/) — Markdown-Playbooks, die Red-Team- und Blue-Team-Workflows mit diesen Werkzeugen durchgehen.

Related MCP server: MoonMCP

Sicherheitsmodell: Bereichssteuerung

Kein Red-Team-Tool wird gegen ein Ziel ausgeführt, das nicht ausdrücklich autorisiert ist. Jedes Tool, das ein Netzwerkziel berührt (nmap_scan, gobuster_dir, nikto_scan, hydra_bruteforce), prüft zuerst scope.yaml und lehnt mit einer klaren Nachricht ab, wenn das Ziel nicht mit einer gültigen, nicht abgelaufenen Autorisierung aufgeführt ist.

cp scope.example.yaml scope.yaml
# edit scope.yaml: add host/cidr, authorized_by, authorization_ref, expires

scope.yaml ist gitignored — es ist lokal, wird nie veröffentlicht. Siehe docs/SCOPE.md für den vollständigen Vertrag.

Blue-Team-Tools (audit_listening_ports, audit_suid_world_writable, review_auth_log, lint_ssh_config, audit_pacman_packages, crack_hash_offline) sind nur lokal und nicht gesteuert — sie berühren nie einen Dritten.

Dieses Projekt gewährt keine Autorisierung, etwas zu testen. Sie sind dafür verantwortlich, eine ausdrückliche schriftliche Genehmigung einzuholen, bevor Sie ein Red-Team-Tool auf ein Ziel richten. Nicht autorisiertes Scannen/Ausnutzen von Systemen, die Sie nicht besitzen oder für die Sie keine schriftliche Testgenehmigung haben, ist in den meisten Rechtsordnungen illegal.

Installation

sudo pacman -S --needed python-uv
uv sync

MCP-Server eigenständig ausführen

uv run python -m blackarch_ai_mcp.server

Bei Claude Code registrieren

claude mcp add blackarch-ai -- uv --directory /path/to/blackarch-ai run python -m blackarch_ai_mcp.server

Dann rufen Sie in einer Claude Code-Sitzung einen Skill auf (z. B. „führen Sie eine Host-Überprüfung durch“ oder /blue-team-host-audit, wenn Slash-Aufruf aktiviert ist) oder rufen Sie ein mcp__blackarch-ai__*-Tool direkt auf.

Aufbau

Siehe docs/ARCHITECTURE.md für die Zusammenstellung der Teile und docs/TOOLS.md für die vollständige Werkzeugreferenz.

Tests

uv run pytest

Lizenz

MIT — siehe LICENSE.