Ctf Time MCP

🚀 CTFtime MCP Server

CTFtime MCP Serverは、CTFtime.orgのデータにプログラムからアクセスできるようにするModel Context Protocol (MCP)サーバーです。標準化されたインターフェースを通じて、CTFコンペティション、チームランキング、イベント詳細、コンペティション結果に関する情報を取得できます。

✨ 主な機能

ツール

プロンプト

リソース

📦 インストール

前提条件

• 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互換のクライアントに接続したら、以下のようなクエリを実行できます。

• "今後2週間のCTFコンペティションのリストを表示"
• "CTFイベントID 2345の詳細を取得"
• "グローバルで上位20のCTFチームを表示"
• "ドイツのCTFチームを検索"
• "DEF CON関連のCTFイベントを検索"
• "2026年3月のCTFカレンダーを表示"

📚 ドキュメント

このサーバーは、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の規則に従っています。

コントリビュートの方法

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/enhancement)。
3. 変更をコミットします (git commit -m 'Add enhancement')。
4. ブランチにプッシュします (git push origin feature/enhancement)。
5. プルリクエストを開きます。

📄 ライセンス

このプロジェクトは、MITライセンスの下でライセンスされています。詳細はLICENSEを参照してください。

謝辞

• CTFtime.org - コンペティションの追跡プラットフォームとAPI
• Model Context Protocol - プロトコル仕様
• MCP Python SDK - サーバー実装フレームワーク

免責事項

これは独立したプロジェクトであり、CTFtime.orgとは関係がなく、承認も受けていません。CTFtime.orgのサービス利用規約とAPI利用ガイドラインを確認し、遵守してください。