Codeforces MCP

🚀 Codeforces MCP Server

Codeforces APIへのシームレスなアクセスを提供するモデルコンテキストプロトコル（MCP）サーバーです。このサーバーを使用すると、標準化されたMCPインターフェースを通じて、Codeforcesのコンテスト、ユーザーデータ、提出、レーティングとやり取りすることができます。

✨ 主な機能

• コンテスト管理：コンテストの一覧、順位表、レーティングの変更を取得します。
• ユーザー情報：ユーザープロファイル、レーティング履歴、提出履歴を取得します。
• 提出追跡：最近の提出と特定のコンテストの提出にアクセスします。
• レーティングデータ：ユーザーのレーティング変更とレーティング付きユーザーの一覧を取得します。
• 非同期サポート：最適なパフォーマンスを得るためにasync/awaitで構築されています。

🛠️ 利用可能なツール

コンテストツール

• get_contest_list - コンテストの一覧を取得します（オプションでジムとグループのフィルターを指定できます）。
• get_contest_rating_changes - 特定のコンテスト後のレーティング変更を取得します。
• get_contest_standings - カスタマイズ可能なフィルターでコンテストの順位表を取得します。
• get_contest_status - 特定のコンテストの提出を取得します。

ユーザーツール

• get_user_info - 詳細なユーザー情報を取得します。
• get_user_rating - ユーザーの完全なレーティング履歴を取得します。
• get_user_submissions - ユーザーの提出履歴を取得します。
• get_rated_users - すべてのレーティング付きユーザーの一覧を取得します。

一般ツール

• get_recent_submissions - プラットフォーム全体の最近の提出を取得します。

📁 プロジェクト構成

.
├── Dockerfile              # Dockerコンテナの設定 
├── LICENSE                 
├── README.md              
└── src/                   
    ├── codeforces_mcp.py  # Codeforces APIと統合されたメインのMCPサーバーの実装。
    └── requirements.txt   # Pythonの依存関係。

📦 インストール

Docker（推奨）

1. Docker Hubからイメージを取得する：

docker pull mohamed2x/codeforces-mcp

2. コンテナを実行する：

docker run -i --rm mohamed2x/codeforces-mcp:latest

⚙️ 設定

サーバーはデフォルトでstdioトランスポートで実行され、https://codeforces.com/apiの公式Codeforces APIに接続します。

依存関係

• fastmcp - MCPサーバーフレームワーク
• httpx - 非同期HTTPクライアント
• urllib.parse - URLパラメータのエンコーディング