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 文件，具体许可信息请查看该文件。