Servidor MCP de Chess.com

Un servidor de Protocolo de Contexto de Modelo (MCP) para la API de datos publicados de Chess.com.

Esto proporciona acceso a los datos de los jugadores de Chess.com, registros de partidas y otra información pública a través de interfaces MCP estandarizadas, lo que permite a los asistentes de IA buscar y analizar información de ajedrez.

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

Características

• [x] Acceda a perfiles de jugadores, estadísticas y registros de juegos

• [x] Buscar juegos por fecha y jugador

• [x] Verificar el estado en línea del jugador

• [x] Obtenga información sobre clubes y jugadores titulados

• [x] No se requiere autenticación (utiliza la API pública de Chess.com)

• [x] Compatibilidad con contenedores Docker

• [x] Proporcionar herramientas interactivas para asistentes de IA

La lista de herramientas es configurable, por lo que puedes elegir qué herramientas quieres que estén disponibles para el cliente MCP.

Related MCP server: Chess.com MCP Server

Uso

Docker (recomendado)

La forma más sencilla de ejecutar chess-mcp con Claude Desktop es usando Docker. Si no tienes Docker instalado, puedes descargarlo desde su sitio web oficial .

Edite el archivo de configuración de Claude Desktop:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json

• Ventanas: %APPDATA%/Claude/claude_desktop_config.json

• Linux: ~/.config/Claude/claude_desktop_config.json

Luego agregue la siguiente configuración:

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

Corriendo con UV

Como alternativa, puede ejecutar el servidor directamente con UV. Edite el archivo de configuración de Claude Desktop (ubicaciones indicadas arriba) y agregue la configuración del servidor:

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

Nota: si ve Error: spawn uv ENOENT en Claude Desktop , es posible que deba especificar la ruta completa a uv o establecer la variable de entorno NO_UV=1 en la configuración.

Desarrollo

¡Agradecemos sus contribuciones! Abra un problema o envíe una solicitud de incorporación de cambios si tiene alguna sugerencia o mejora.

Este proyecto utiliza uv para gestionar las dependencias. Instale uv siguiendo las instrucciones para su plataforma:

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

Luego puede crear un entorno virtual e instalar las dependencias con:

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

Pruebas

El proyecto incluye un conjunto de pruebas que garantiza la funcionalidad y ayuda a prevenir regresiones.

Ejecute las pruebas con pytest:

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

# Run the tests
pytest

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

Herramientas disponibles

Información del jugador

• get_player_profile - Obtener el perfil de un jugador de Chess.com

• get_player_stats - Obtén las estadísticas de un jugador de Chess.com

• is_player_online - Comprueba si un jugador está actualmente en línea en Chess.com

• get_titled_players - Obtenga una lista de jugadores titulados de Chess.com

Juegos

• get_player_current_games : Obtener las partidas actuales de un jugador en Chess.com

• get_player_games_by_month : obtén las partidas de un jugador durante un mes específico en Chess.com

• get_player_game_archives : Obtenga una lista de los archivos de partidas mensuales disponibles para un jugador en Chess.com

• download_player_games_pgn - Descarga archivos PGN de todas las partidas de un mes específico desde Chess.com

Clubs

• get_club_profile - Obtén información sobre un club en Chess.com

• get_club_members - Consigue miembros para un club en Chess.com

Licencia

Instituto Tecnológico de Massachusetts (MIT)