remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides access to Chess.com player data, profiles, statistics, game records, online status checks, club information, and titled player lists through Chess.com's Published Data API.

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.

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)

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Proporciona acceso a los datos de los jugadores de Chess.com, registros de partidas e 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.

Appeared in Searches

A search for games