Chess.com Mcp-Server

Was ist Chess MCP?

Chess MCP ist ein Model Context Protocol-Server, der entwickelt wurde, um mit der veröffentlichten Daten-API von Chess.com zu interagieren. Es bietet eine standardisierte Möglichkeit, auf eine Fülle von schachbezogenen Daten zuzugreifen, einschließlich Spielerstatistiken, Spielaufzeichnungen und anderen öffentlichen Informationen. Dies ermöglicht Entwicklern und KI-Assistenten, Schachinformationen effizient zu durchsuchen und zu analysieren, was es einfacher macht, Anwendungen und Tools zu erstellen, die Schachdaten nutzen.

Funktionen von Chess MCP

• Standardisierte Schnittstellen: Chess MCP nutzt standardisierte Model Context Protocol-Schnittstellen, um einen konsistenten Zugriff auf Daten über verschiedene Anwendungen hinweg zu gewährleisten.
• Umfassender Datenzugriff: Benutzer können detaillierte Spieldaten abrufen, einschließlich Ranglisten, Spielhistorie und Leistungskennzahlen.
• KI-Integration: Das Protokoll ist darauf ausgelegt, die Integration von KI-Assistenten zu erleichtern, sodass diese Schachinformationen analysieren und Einblicke bereitstellen können.
• Öffentliche Informationen: Alle über Chess MCP abgerufenen Daten sind öffentlich verfügbar, was Transparenz und Zugänglichkeit für Entwickler und Benutzer gewährleistet.
• Open Source: Chess MCP ist ein Open-Source-Projekt, das Entwicklern ermöglicht, zur Verbesserung und Erweiterung des Protokolls beizutragen.

So verwenden Sie Chess MCP

1. Umgebung einrichten: Stellen Sie sicher, dass Sie die erforderlichen Tools und Bibliotheken installiert haben, um mit der Chess.com-API zu interagieren.
2. API zugreifen: Verwenden Sie die standardisierten MCP-Schnittstellen, um eine Verbindung zu den Chess.com-Daten herzustellen. Dies beinhaltet in der Regel das Senden von HTTP-Anfragen an die API-Endpunkte.
3. Daten abrufen: Nutzen Sie die verschiedenen Endpunkte, um Spieldaten, Spielaufzeichnungen und andere relevante Informationen abzurufen.
4. Daten analysieren: Implementieren Sie Logik in Ihrer Anwendung, um die abgerufenen Daten zu analysieren, sei es für den persönlichen Gebrauch, das Training von KI oder andere Zwecke.
5. Zum Projekt beitragen: Wenn Sie Verbesserungen oder Funktionen hinzufügen möchten, ziehen Sie in Betracht, zum Chess MCP-Repository auf GitHub beizutragen.

Häufig gestellte Fragen

F: Welche Art von Daten kann ich mit Chess MCP abrufen?

A: Sie können eine Vielzahl von schachbezogenen Daten abrufen, einschließlich Spielerprofile, Spielhistorien und Statistiken von Chess.com.

F: Ist Chess MCP kostenlos zu verwenden?

A: Ja, Chess MCP ist ein Open-Source-Projekt, und alle über es abgerufenen Daten sind öffentlich verfügbar.

F: Kann ich Chess MCP mit KI-Anwendungen integrieren?

A: Absolut! Chess MCP ist darauf ausgelegt, die KI-Integration zu erleichtern, sodass KI-Assistenten Schachdaten analysieren und Einblicke bereitstellen können.

F: Wie kann ich zu Chess MCP beitragen?

A: Sie können beitragen, indem Sie das Repository auf GitHub forken, Ihre Änderungen vornehmen und einen Pull-Request zur Überprüfung einreichen.

F: Wo finde ich die Dokumentation für Chess MCP?

A: Die Dokumentation ist in der Regel in der README-Datei des Repositories oder in einem speziellen Dokumentationsbereich innerhalb des Projekts verfügbar.

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