Chess.com Server Mcp

Cos'è Chess MCP?

Chess MCP è un server del Model Context Protocol progettato per interfacciarsi con l'API dei Dati Pubblicati di Chess.com. Fornisce un modo standardizzato per accedere a una vasta gamma di dati relativi agli scacchi, inclusi statistiche dei giocatori, registrazioni delle partite e altre informazioni pubbliche. Questo consente a sviluppatori e assistenti AI di cercare e analizzare in modo efficiente le informazioni sugli scacchi, facilitando la creazione di applicazioni e strumenti che sfruttano i dati degli scacchi.

Caratteristiche di Chess MCP

• Interfacce Standardizzate: Chess MCP utilizza interfacce standardizzate del Model Context Protocol, garantendo un accesso coerente ai dati attraverso diverse applicazioni.
• Accesso Completo ai Dati: Gli utenti possono recuperare dati dettagliati sui giocatori, inclusi classifiche, cronologia delle partite e metriche di prestazione.
• Integrazione AI: Il protocollo è progettato per facilitare l'integrazione di assistenti AI, consentendo loro di analizzare le informazioni sugli scacchi e fornire approfondimenti.
• Informazioni Pubbliche: Tutti i dati accessibili tramite Chess MCP sono disponibili pubblicamente, garantendo trasparenza e accessibilità per sviluppatori e utenti.
• Open Source: Chess MCP è un progetto open-source, che consente agli sviluppatori di contribuire, modificare e migliorare il protocollo secondo necessità.

Come Utilizzare Chess MCP

1. Configura l'Ambiente: Assicurati di avere gli strumenti e le librerie necessari installati per interagire con l'API di Chess.com.
2. Accedi all'API: Utilizza le interfacce MCP standardizzate per connetterti ai dati di Chess.com. Questo comporta tipicamente l'invio di richieste HTTP agli endpoint dell'API.
3. Recupera Dati: Utilizza i vari endpoint per recuperare dati sui giocatori, registrazioni delle partite e altre informazioni rilevanti.
4. Analizza i Dati: Implementa la logica nella tua applicazione per analizzare i dati recuperati, sia per uso personale, addestramento AI o altri scopi.
5. Contribuisci al Progetto: Se hai miglioramenti o funzionalità da aggiungere, considera di contribuire al repository di Chess MCP su GitHub.

Domande Frequenti

D: Che tipo di dati posso accedere con Chess MCP?

R: Puoi accedere a una varietà di dati relativi agli scacchi, inclusi profili dei giocatori, cronologie delle partite e statistiche di Chess.com.

D: Chess MCP è gratuito da usare?

R: Sì, Chess MCP è un progetto open-source e tutti i dati accessibili tramite esso sono disponibili pubblicamente.

D: Posso integrare Chess MCP con applicazioni AI?

R: Assolutamente! Chess MCP è progettato per facilitare l'integrazione AI, consentendo agli assistenti AI di analizzare e fornire approfondimenti basati sui dati degli scacchi.

D: Come posso contribuire a Chess MCP?

R: Puoi contribuire facendo un fork del repository su GitHub, apportando le tue modifiche e inviando una pull request per la revisione.

D: Dove posso trovare la documentazione per Chess MCP?

R: La documentazione è solitamente disponibile nel file README del repository o in una sezione di documentazione dedicata all'interno del progetto.

Chess.com MCP Server

A Model Context Protocol (MCP) server for Chess.com's Published Data API.

This 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.

https://github.com/user-attachments/assets/3b33361b-b604-465c-9f6a-3699b6907757

Features

• Access player profiles, stats, and game records
• Search games by date and player
• Check player online status
• Get information about clubs and titled players
• No authentication required (uses Chess.com's public API)
• Docker containerization support
• Provide interactive tools for AI assistants

The list of tools is configurable, so you can choose which tools you want to make available to the MCP client.

Usage

Docker (Recommended)

The easiest way to run chess-mcp with Claude Desktop is using Docker. If you don't have Docker installed, you can get it from Docker's official website.

Edit your Claude Desktop config file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%/Claude/claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Then add the following configuration:

{
  "mcpServers": {
    "chess": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "pab1it0/chess-mcp"
      ]
    }
  }
}

Running with UV

Alternatively, you can run the server directly using UV. Edit your Claude Desktop config file (locations listed above) and add the server configuration:

{
  "mcpServers": {
    "chess": {
      "command": "uv",
      "args": [
        "--directory",
        "<full path to chess-mcp directory>",
        "run",
        "src/chess_mcp/main.py"
      ]
    }
  }
}

Note: if you see Error: spawn uv ENOENT in Claude Desktop, you may need to specify the full path to uv or set the environment variable NO_UV=1 in the configuration.

Development

Contributions are welcome! Please open an issue or submit a pull request if you have any suggestions or improvements.

This project uses uv to manage dependencies. Install uv following the instructions for your platform:

curl -LsSf https://astral.sh/uv/install.sh | sh

You can then create a virtual environment and install the dependencies with:

uv venv
source .venv/bin/activate  # On Unix/macOS
.venv\Scripts\activate     # On Windows
uv pip install -e .

Testing

The project includes a test suite that ensures functionality and helps prevent regressions.

Run the tests with pytest:

### Install development dependencies
uv pip install -e ".[dev]"

### Run the tests
pytest

### Run with coverage report
pytest --cov=src --cov-report=term-missing

Available Tools

Player Information

• get_player_profile - Get a player's profile from Chess.com
• get_player_stats - Get a player's stats from Chess.com
• is_player_online - Check if a player is currently online on Chess.com
• get_titled_players - Get a list of titled players from Chess.com

Games

• get_player_current_games - Get a player's ongoing games on Chess.com
• get_player_games_by_month - Get a player's games for a specific month from Chess.com
• get_player_game_archives - Get a list of available monthly game archives for a player on Chess.com
• download_player_games_pgn - Download PGN files for all games in a specific month from Chess.com

Clubs

• get_club_profile - Get information about a club on Chess.com
• get_club_members - Get members of a club on Chess.com

License

MIT