Codeforces MCP

🚀 Codeforces MCP 服務器

這是一個模型上下文協議（MCP）服務器，可讓你無縫訪問 Codeforces API。藉助該服務器，你能通過標準化的 MCP 接口與 Codeforces 的競賽、用戶數據、提交記錄和評級進行交互。

✨ 主要特性

• 競賽管理：獲取競賽列表、排名和評級變化。
• 用戶信息：檢索用戶資料、評級歷史和提交記錄。
• 提交跟蹤：訪問近期提交和特定競賽的提交。
• 評級數據：獲取用戶評級變化和有評級的用戶列表。
• 異步支持：採用異步/等待機制構建，實現最佳性能。

🛠️ 可用工具

競賽工具

• 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

⚙️ 配置

服務器默認通過標準輸入輸出傳輸運行，並連接到官方 Codeforces API https://codeforces.com/api。

依賴項

• fastmcp - MCP 服務器框架
• httpx - 異步 HTTP 客戶端
• urllib.parse - URL 參數編碼

📄 許可證

項目包含了 LICENSE 文件，具體許可信息請查看該文件。