blackarch-AI

レッドチームおよびブルーチーム向けのセキュリティワークフローをBlackArch Linux上で実行するための、スコープ制限付きMCPサーバーとClaude Codeスキルセットです。

これは何か

• MCPサーバー（src/blackarch_ai_mcp/） — ローカルのセキュリティツール（nmap、gobuster、nikto、hydra、さらにローカルのブルーチーム監査）をMCPツールとしてラップし、MCP互換クライアントから呼び出せるようにします。

• Claude Codeスキル（.claude/skills/） — それらのツールを使ったレッドチームおよびブルーチームのワークフローを解説するマークダウンプレイブックです。

Related MCP server: MoonMCP

セーフティモデル：スコープ制限

明示的に許可されていないターゲットに対して、レッドチームツールは実行されません。 ネットワークターゲットに触れるすべてのツール（nmap_scan、gobuster_dir、nikto_scan、hydra_bruteforce）は、最初にscope.yamlをチェックし、ターゲットが有効で期限切れでない許可とともにリストされていない場合は、明確なメッセージとともに拒否します。

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

scope.yamlはgitignoreされています — ローカルにあり、公開されることはありません。完全な契約についてはdocs/SCOPE.mdを参照してください。

ブルーチームツール（audit_listening_ports、audit_suid_world_writable、review_auth_log、lint_ssh_config、audit_pacman_packages、crack_hash_offline）はローカルのみで、制限されません — これらはサードパーティに触れることはありません。

このプロジェクトは、何かをテストする許可を与えるものではありません。 レッドチームツールをターゲットに向ける前に、明示的な書面による許可を得る責任はあなたにあります。自分が所有していない、または書面によるテスト許可がないシステムに対する無許可のスキャンや悪用は、ほとんどの法域で違法です。

インストール

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

MCPサーバーをスタンドアロンで実行

uv run python -m blackarch_ai_mcp.server

Claude Codeに登録

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

その後、Claude Codeセッションでスキルを呼び出すか（例：「ホスト監査を実行」、またはスラッシュ呼び出しが有効な場合は/blue-team-host-audit）、mcp__blackarch-ai__*ツールを直接呼び出します。

レイアウト

各要素がどのように連携するかについてはdocs/ARCHITECTURE.mdを、完全なツールリファレンスについてはdocs/TOOLS.mdを参照してください。

テスト

uv run pytest

ライセンス

MIT — LICENSEを参照してください。