margaritashub/mcp-chess-server

Chess MCP Server

A Model Context Protocol (MCP) server that integrates with the Chess.com API to provide chess player information and statistics. This server allows AI assistants to fetch real-time data about chess players, including their ratings, game history, and profile information.

Features

• Retrieve detailed player profiles from Chess.com
• Get comprehensive player statistics including:
  • Blitz, Rapid, and Bullet ratings
  • Best historical ratings with dates
  • Win/Loss/Draw records
  • FIDE ratings
  • Tactics ratings
  • Puzzle Rush scores

Installation

Install this mcp server by adding the following JSON code to your config file:

{
    "servers": {
        "chess": {
            "command": "uvx",
            "args": [
                "--from",
                "git+https://github.com/margaritashub/mcp-chess-server.git",
                "chess"
            ]
        }
    }
}

Usage

Starting the Server

chess

The server will start and be ready to handle MCP requests.

Available Methods

1. get_chess_player_profile

   • Gets a player's Chess.com profile information
   • Parameter: username (Chess.com username)
   • Returns: Player details including name, title, location, followers, etc.

2. get_chess_player_stats

   • Gets a player's comprehensive chess statistics
   • Parameter: username (Chess.com username)
   • Returns: Detailed statistics for various chess formats (blitz, rapid, bullet, etc.)

Dependencies

• mcp[cli] >= 1.14.1
• openai >= 1.108.1
• requests >= 2.32.5

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Acknowledgments

• Chess.com for providing the public API
• Model Context Protocol (MCP) framework