Ez Xbow Platform MCP

🚀 EZ XBow Challenge MCP

このツールは、AI 駆動の浸透テストコンテスト用のモデルコンテキストプロトコル (MCP) サーバーです。完全な API インターフェースを提供し、LLM が自主的に CTF チャレンジに参加できるようにします。

💡 使用アドバイス

kimi-cli-for-xbow と一緒に使用するか、独自のエージェントワークフローに統合することをおすすめします。

✨ 主な機能

• チャレンジ管理 - CTF チャレンジの一覧表示、試行、およびソリューションの提出が可能です。
• 知識ベース - 9 種類の脆弱性カテゴリをカバーする CTF 技術文書が内蔵されています。
• 永続的な Kali コンテナ - 隔離された環境でセキュリティツール（nmap、sqlmap、gobuster など）を実行できます。
• 試行履歴 - 自動ノート管理により、セッションをまたいで発見を追跡および共有できます。
• 複数のプロトコル - stdio、SSE、および HTTP/2 ストリームモードをサポートしています。

🚀 クイックスタート

前提条件

• Go 1.24.7 以上
• buildx をサポートする Docker

ビルド

go build -o xbow-mcp ./cmd/main.go

モックプラットフォームでの実行（テスト）

./mock-challenges 内でテンプレートに従って対応する問題ファイルを作成します。

{
    "challenge_code": "XBEN-123-24",
    "difficulty": "easy",
    "points": 200,
    "target_info": {
        "ip": "192.168.5.37",
        "port": [32820]
    },
    "hint_viewed": false,
    "solved": true,
    "hint_content": "Sometimes the AuthN/AuthZ checks are vulnerable to TOCTOU issues if they are not implemented properly",
    "solution": "flag{xxxx}"
}

起動コマンド:

./xbow-mcp --mock  -listen 127.0.0.1:8080

実際のプラットフォームでの実行

./xbow-mcp \
  -xbow-url https://your-xbow-platform.com \
  -xbow-token YOUR_AUTH_TOKEN \
  -mode streamable \
  -listen 127.0.0.1:8080

🛠️ 利用可能なツール

⚙️ コマンドラインオプション

# サーバーモード
-mode, -m [stdio|sse|streamable]       MCP サーバープロトコル (デフォルト: streamable)
-listen, -l ADDR:PORT                  リスンアドレス (デフォルト: 127.0.0.1:8080)

# プラットフォーム設定
-xbow-url, -u URL                      XBow API ベース URL
-xbow-token, -t TOKEN                  認証トークン

# Docker 設定
-docker-container, -c NAME             コンテナ名 (デフォルト: xbow-kail)
-docker-image, -i IMAGE:TAG            Docker イメージ (デフォルト: xbow-kail:latest)
-dockerfile-dir, -f PATH               Dockerfile のパス (デフォルト: ./Dockerfile)
-docker-exec-log-dir, -d DIR           実行ログディレクトリ (デフォルト: ./.kail-history)

# モックプラットフォーム（ローカルテスト）
--mock                                 モックプラットフォームサーバーを有効にする
-mock-addr ADDR:PORT                   モックサーバーアドレス (デフォルト: 127.0.0.1:8000)
-mock-dir PATH                         モックチャレンジディレクトリ (デフォルト: ./mock-challenges)

🧩 統合

MCP クライアント

あなたの MCP クライアント設定に追加します。

{
    "mcpServers": {
        "ezmcp": {
            "url": "http://127.0.0.1:8080/mcp"
        }
    }
}

💾 ローカルストレージ

• .challenge_history/{challenge_code}/ - 試行メタデータ、ノート、および履歴
• .kail-history/ - コマンド実行記録

📋 TODO

• XBOW ターゲット環境を自動的にコンパイルして起動し、問題情報を設定する。

📄 ライセンス

オープンソースです。詳細は LICENSE ファイルを参照してください。

👥 貢献

Issue や Pull Request の提出を歓迎します。