Mohamed-hanfy/codeforces-mcp
If you are the rightful owner of codeforces-mcp and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server that provides seamless access to the Codeforces API.
The Codeforces MCP Server is designed to facilitate interaction with the Codeforces platform through a standardized Model Context Protocol interface. This server enables users to access a wide range of functionalities related to Codeforces contests, user data, submissions, and ratings. By leveraging the Codeforces API, the server offers a streamlined and efficient way to retrieve and manage data, making it an invaluable tool for developers and competitive programming enthusiasts. The server is built with asynchronous support using async/await, ensuring optimal performance and responsiveness. It is containerized using Docker, allowing for easy deployment and scalability. The server's architecture is designed to be robust and flexible, accommodating various use cases and integration scenarios.
Features
- Contest Management: Access contest lists, standings, and rating changes.
- User Information: Retrieve user profiles, rating history, and submissions.
- Submission Tracking: Monitor recent submissions and contest-specific submissions.
- Rating Data: Obtain user rating changes and lists of rated users.
- Async Support: Built with async/await for enhanced performance.
Usages
docker usage
bash docker pull mohamed2x/codeforces-mcp docker run -i --rm mohamed2x/codeforces-mcp:latest
local stdio usage
python mcp.run(transport='stdio') # Connects to Codeforces API
Tools
get_contest_list
Get list of contests (with optional gym and group filters)
get_contest_rating_changes
Get rating changes after a specific contest
get_contest_standings
Get contest standings with customizable filters
get_contest_status
Get submissions for a specific contest
get_user_info
Get detailed user information
get_user_rating
Get user's complete rating history
get_user_submissions
Get user's submission history
get_rated_users
Get list of all rated users
get_recent_submissions
Get recent submissions across the platform