chess-mcp

chess-mcp

36

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