Servidor Mcp de Chess.com

¿Qué es Chess MCP?

Chess MCP es un servidor de Protocolo de Contexto de Modelo diseñado para interactuar con la API de Datos Publicados de Chess.com. Proporciona una forma estandarizada de acceder a una gran cantidad de datos relacionados con el ajedrez, incluyendo estadísticas de jugadores, registros de partidas y otra información pública. Esto permite a los desarrolladores y asistentes de IA buscar y analizar información de ajedrez de manera eficiente, facilitando la creación de aplicaciones y herramientas que aprovechan los datos de ajedrez.

Características de Chess MCP

• Interfaces Estandarizadas: Chess MCP utiliza interfaces estandarizadas del Protocolo de Contexto de Modelo, asegurando un acceso consistente a los datos a través de diferentes aplicaciones.
• Acceso a Datos Comprensivo: Los usuarios pueden recuperar datos detallados de jugadores, incluyendo clasificaciones, historial de partidas y métricas de rendimiento.
• Integración de IA: El protocolo está diseñado para facilitar la integración de asistentes de IA, permitiéndoles analizar información de ajedrez y proporcionar insights.
• Información Pública: Todos los datos accesibles a través de Chess MCP son de acceso público, garantizando transparencia y accesibilidad para desarrolladores y usuarios por igual.
• Código Abierto: Chess MCP es un proyecto de código abierto, lo que permite a los desarrolladores contribuir, modificar y mejorar el protocolo según sea necesario.

Cómo Usar Chess MCP

1. Configura el Entorno: Asegúrate de tener las herramientas y bibliotecas necesarias instaladas para interactuar con la API de Chess.com.
2. Accede a la API: Utiliza las interfaces estandarizadas de MCP para conectarte a los datos de Chess.com. Esto generalmente implica hacer solicitudes HTTP a los puntos finales de la API.
3. Recupera Datos: Utiliza los diversos puntos finales para obtener datos de jugadores, registros de partidas y otra información relevante.
4. Analiza los Datos: Implementa lógica en tu aplicación para analizar los datos recuperados, ya sea para uso personal, entrenamiento de IA u otros propósitos.
5. Contribuye al Proyecto: Si tienes mejoras o características para agregar, considera contribuir al repositorio de Chess MCP en GitHub.

Preguntas Frecuentes

P: ¿Qué tipo de datos puedo acceder con Chess MCP?

R: Puedes acceder a una variedad de datos relacionados con el ajedrez, incluyendo perfiles de jugadores, historiales de partidas y estadísticas de Chess.com.

P: ¿Es Chess MCP gratuito para usar?

R: Sí, Chess MCP es un proyecto de código abierto, y todos los datos accesibles a través de él son de acceso público.

P: ¿Puedo integrar Chess MCP con aplicaciones de IA?

R: ¡Absolutamente! Chess MCP está diseñado para facilitar la integración de IA, permitiendo que los asistentes de IA analicen y proporcionen insights basados en datos de ajedrez.

P: ¿Cómo puedo contribuir a Chess MCP?

R: Puedes contribuir haciendo un fork del repositorio en GitHub, realizando tus cambios y enviando una solicitud de extracción para revisión.

P: ¿Dónde puedo encontrar la documentación para Chess MCP?

R: La documentación generalmente está disponible en el archivo README del repositorio o en una sección de documentación dedicada dentro del proyecto.

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