JinDaGe - codeforces-mcp MCP Details

article

README

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

codeforces-mcp