Ez Xbow Platform MCP

🚀 EZ XBow Challenge MCP

這是一個用於 AI 驅動的滲透測試競賽的模型上下文協議 (MCP) 服務器。該工具提供了一套完整的 API 接口，能讓大語言模型（LLM）自主參與 CTF 挑戰。

💡 使用建議

建議將本工具與 kimi-cli-for-xbow 配合使用，或者將其集成到你自己的 Agent 工作流中。

✨ 主要特性

• 挑戰管理：可以列出 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                  認證 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。