Serveur Mcp de Chess.com

Qu'est-ce que Chess MCP ?

Chess MCP est un serveur de Protocole de Contexte de Modèle conçu pour interagir avec l'API de Données Publiées de Chess.com. Il fournit un moyen standardisé d'accéder à une richesse de données liées aux échecs, y compris les statistiques des joueurs, les historiques de parties et d'autres informations publiques. Cela permet aux développeurs et aux assistants IA de rechercher et d'analyser efficacement les informations sur les échecs, facilitant ainsi la création d'applications et d'outils qui exploitent les données échiquéennes.

Fonctionnalités de Chess MCP

• Interfaces Standardisées : Chess MCP utilise des interfaces standardisées de Protocole de Contexte de Modèle, garantissant un accès cohérent aux données à travers différentes applications.
• Accès Complet aux Données : Les utilisateurs peuvent récupérer des données détaillées sur les joueurs, y compris les classements, l'historique des parties et les métriques de performance.
• Intégration IA : Le protocole est conçu pour faciliter l'intégration des assistants IA, leur permettant d'analyser les informations échiquéennes et de fournir des insights.
• Informations Publiques : Toutes les données accessibles via Chess MCP sont disponibles publiquement, garantissant transparence et accessibilité pour les développeurs et les utilisateurs.
• Open Source : Chess MCP est un projet open-source, permettant aux développeurs de contribuer, de modifier et d'améliorer le protocole selon les besoins.

Comment Utiliser Chess MCP

1. Configurer l'Environnement : Assurez-vous d'avoir les outils et bibliothèques nécessaires installés pour interagir avec l'API de Chess.com.
2. Accéder à l'API : Utilisez les interfaces MCP standardisées pour vous connecter aux données de Chess.com. Cela implique généralement de faire des requêtes HTTP aux points de terminaison de l'API.
3. Récupérer des Données : Utilisez les différents points de terminaison pour récupérer des données sur les joueurs, les historiques de parties et d'autres informations pertinentes.
4. Analyser les Données : Implémentez une logique dans votre application pour analyser les données récupérées, que ce soit pour un usage personnel, pour l'entraînement de l'IA ou d'autres fins.
5. Contribuer au Projet : Si vous avez des améliorations ou des fonctionnalités à ajouter, envisagez de contribuer au dépôt Chess MCP sur GitHub.

Questions Fréquemment Posées

Q : Quel type de données puis-je accéder avec Chess MCP ?

R : Vous pouvez accéder à une variété de données liées aux échecs, y compris des profils de joueurs, des historiques de parties et des statistiques de Chess.com.

Q : Chess MCP est-il gratuit à utiliser ?

R : Oui, Chess MCP est un projet open-source, et toutes les données accessibles via celui-ci sont disponibles publiquement.

Q : Puis-je intégrer Chess MCP avec des applications IA ?

R : Absolument ! Chess MCP est conçu pour faciliter l'intégration de l'IA, permettant aux assistants IA d'analyser et de fournir des insights basés sur les données échiquéennes.

Q : Comment puis-je contribuer à Chess MCP ?

R : Vous pouvez contribuer en forkant le dépôt sur GitHub, en apportant vos modifications et en soumettant une demande de tirage pour révision.

Q : Où puis-je trouver la documentation pour Chess MCP ?

R : La documentation est généralement disponible dans le fichier README du dépôt ou dans une section de documentation dédiée au sein du projet.

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