chess-mcp
Chess.com MCP Server is a Model Context Protocol server that allows access to Chess.com's public data, including player profiles, game records, and club information. This server facilitates AI assistants to efficiently search and analyze chess-related data.
Chess.com MCP Server
A Model Context Protocol (MCP) server for Chess.com's Published Data API. This server provides access to Chess.com player data, game records, and other public information through standardized MCP interfaces, allowing AI assistants to search and analyze chess information.
Features
- Access player profiles, stats, and game records
- Search games by date and player
- Check player online status
- Obtain information about clubs and titled players
- No authentication required
- Docker containerization support
- Provide interactive tools for AI assistants
Usage
Docker (Recommended)
Use Docker to run chess-mcp, particularly with Claude Desktop by editing the config file.
Running with UV
Alternatively, run the server directly using UV by configuring Claude Desktop.
Development
Contributions are welcome. The project uses uv
to manage dependencies; install it and create a virtual environment to install dependencies.
Testing
The project has a test suite run with pytest to ensure functionality and prevent regressions.
Available Tools
Player Information
- Get player profiles, stats, and online status
- Get titled players list
Games
- Retrieve ongoing player games, monthly games, and game archives
- Download PGN files
Clubs
- Access club profiles and members
License
MIT