🚀 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（推荐）
- 从 Docker Hub 拉取镜像：
docker pull mohamed2x/codeforces-mcp
- 运行容器：
docker run -i --rm mohamed2x/codeforces-mcp:latest
⚙️ 配置
服务器默认通过标准输入输出传输运行，并连接到官方 Codeforces API https://codeforces.com/api。
依赖项
fastmcp- MCP 服务器框架httpx- 异步 HTTP 客户端urllib.parse- URL 参数编码
📄 许可证
项目包含了 LICENSE 文件，具体许可信息请查看该文件。