Ctf Time MCP

🚀 CTFtime MCP Server

CTFtime MCP Server 是一個基於 Model Context Protocol (MCP) 的服務器，它提供了一種程序化的方式來訪問 CTFtime.org 的數據。通過標準化接口，你可以獲取 CTF 競賽、團隊排名、賽事詳情以及競賽結果等信息。

🚀 快速開始

CTFtime MCP Server 提供了便捷的方式來獲取 CTFtime.org 的數據。你可以按照以下步驟進行安裝和使用。

✨ 主要特性

工具

提示

資源

📦 安裝指南

前提條件

• Python 3.13 或更高版本
• uv（推薦）或 pip

使用 uv（推薦）

git clone https://github.com/0x-Professor/CTF-time-mcp.git
cd ctf-times-mcp
uv sync

使用 pip

git clone https://github.com/yourusername/ctf-times-mcp.git
cd ctf-times-mcp
pip install -e .

💻 使用示例

運行服務器

# 使用 uv
uv run server.py

# 直接使用 Python
python server.py

開發模式

# 使用 MCP Inspector 進行測試
uv run mcp dev server.py

客戶端配置

要將 CTFtime MCP 服務器添加到 Claude Desktop，請運行以下命令：

uv run mcp install server.py --name "CTFtime"

Claude Desktop

將以下內容添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "ctftime": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/ctf-times-mcp", "server.py"]
    }
  }
}

VS Code with Continue

將以下內容添加到你的 Continue 配置中：

{
  "mcpServers": [
    {
      "name": "ctftime",
      "command": "uv",
      "args": ["run", "server.py"],
      "cwd": "/path/to/ctf-times-mcp"
    }
  ]
}

示例查詢

連接到兼容 MCP 的客戶端後，你可以嘗試以下查詢：

• "列出未來兩週內即將舉行的 CTF 競賽"
• "獲取 CTF 賽事 ID 為 2345 的詳細信息"
• "顯示全球排名前 20 的 CTF 團隊"
• "查找來自德國的 CTF 團隊"
• "搜索與 DEF CON 相關的 CTF 賽事"
• "顯示 2026 年 3 月的 CTF 日曆"

📚 詳細文檔

API 參考

本服務器與 CTFtime.org API 進行交互。

使用的端點

速率限制

CTFtime.org API 用於數據分析和應用開發。請實施適當的請求節流，以尊重服務器資源。

競賽格式

挑戰類別

🔧 技術細節

項目結構

ctf-times-mcp/
├── server.py          # MCP 服務器實現
├── pyproject.toml     # 項目配置和依賴項
└── README.md          # 文檔

開發

測試

# 使用 MCP Inspector 運行
uv run mcp dev server.py

# 執行測試
uv run pytest

代碼風格

本項目遵循 PEP 8 規範，並在整個項目中使用類型註解。

📄 許可證

本項目採用 MIT 許可證。有關詳細信息，請參閱 LICENSE。

致謝

• CTFtime.org - 競賽跟蹤平臺和 API
• Model Context Protocol - 協議規範
• MCP Python SDK - 服務器實現框架

免責聲明

這是一個獨立項目，與 CTFtime.org 沒有關聯或得到其認可。請查看並遵守 CTFtime.org 的服務條款和 API 使用指南。