Codeforces MCP Server

这是一个基于模型上下文协议（MCP）的服务器，提供无缝访问Codeforces API的功能。该服务器允许您通过标准化的MCP接口与Codeforces的比赛、用户数据、提交记录和评分进行交互。

功能

• 比赛管理：获取比赛列表、排名和评分变化
• 用户信息：检索用户资料、评分历史和提交记录
• 提交跟踪：访问最近的提交记录和特定比赛的提交记录
• 评分数据：获取用户的评分变化和已评分用户列表
• 异步支持：使用async/await构建以实现最佳性能

可用工具

比赛工具

• get_contest_list - 获取比赛列表（可选的gym和组过滤器）
• 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  # 主要的MCP服务器实现，集成Codeforces API。
    └── requirements.txt   # Python依赖项。

安装

Docker（推荐）

1. 从Docker Hub拉取镜像：

docker pull mohamed2x/codeforces-mcp

2. 运行容器：

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

配置

服务器默认使用stdio传输，并连接到官方Codeforces API地址https://codeforces.com/api。

依赖项

• fastmcp - MCP服务器框架
• httpx - 异步HTTP客户端
• urllib.parse - URL参数编码