Lichess MCP

insignia de herrería

Habla con Lichess en lenguaje natural para interactuar con la plataforma de ajedrez. Úsalo con Claude Desktop para jugar partidas, analizar posiciones y gestionar tus actividades de ajedrez.

Construido utilizando el Protocolo de Contexto de Modelo .

El servidor permite:

Administrar su cuenta de Lichess
Jugando partidas de ajedrez y desafíos
Analizando posiciones y juegos
Unirse a torneos y equipos
Interactuar con otros jugadores

Configuración

El token de API de Lichess se puede configurar de dos maneras:

Variables de entorno: agréguelas a su archivo .env en la raíz del proyecto o configúrelas directamente:
LICHESS_TOKEN=your-lichess-api-token
Usando la herramienta set_token durante el tiempo de ejecución:
set_token({ token: "your-lichess-api-token" });

El token se puede generar en https://lichess.org/account/oauth/token

Related MCP server: Claude-LMStudio Bridge

Herramientas disponibles

1. Gestión de cuentas

// Set your Lichess API token set_token({ token: "your-lichess-api-token" }); // Get your Lichess profile get_my_profile(); // Get another user's profile get_user_profile({ username: "player_name", trophies: true // include trophies, optional });

2. Jugabilidad

// Create a challenge against another player create_challenge({ username: "opponent_username", timeControl: "10+0", // 10 minutes, no increment color: "random" // or "white", "black" }); // Make a move in a game make_move({ gameId: "abcd1234", move: "e2e4", offeringDraw: false }); // Get your ongoing games get_ongoing_games({ nb: 10 // number of games to fetch });

3. Análisis del juego

// Export a game in PGN format export_game({ gameId: "abcd1234", clocks: true, evals: true }); // Get cloud evaluation for a position get_cloud_eval({ fen: "rnbqkbnr/ppp1pppp/8/3p4/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2" });

4. Torneos

// List current tournaments get_arena_tournaments(); // Join a tournament join_arena({ tournamentId: "abc123" }); // Create a new tournament create_arena({ name: "My Tournament", clockTime: 3, clockIncrement: 2, minutes: 45 });

Notación de ajedrez

Formatos de movimiento

La API de Lichess acepta movimientos en estos formatos:

UCI : Formato de interfaz universal de ajedrez (p. ej., e2e4 , g8f6 )
SAN : Notación algebraica estándar (p. ej., e4 , Nf6 ): solo para algunos puntos finales

Formato FEN

La notación Forsyth-Edwards (FEN) se utiliza para representar posiciones de ajedrez:

rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1

Esto representa:

Posiciones de las piezas (desde la 8ª fila hasta la 1ª fila)
Color activo (b/n)
Disponibilidad de enroque (KQkq)
Cuadrado objetivo al paso
Reloj de medio movimiento
Número de movimiento completo

Manejo de errores

El servidor proporciona mensajes de error detallados para:

Movimientos o posiciones no válidos
Problemas de autenticación
Límites de velocidad
Casos de recurso no encontrado

Instrucciones de configuración

Instalación mediante herrería

Para instalar Lichess Integration para Claude Desktop automáticamente a través de Smithery :

npx -y @smithery/cli install @karayaman/lichess-mcp --client claude

Instalación manual

Clonar el repositorio:
git clone https://github.com/karayaman/lichess-mcp.git cd lichess-mcp
Instalar dependencias:
npm install
Configurar variables de entorno: Cree un archivo .env en el directorio raíz:
LICHESS_TOKEN=your-lichess-api-token
Construir el proyecto:
npm run build
Instalar el paquete globalmente (recomendado para la integración de Claude Desktop):
npm install -g
Iniciar el servidor (para uso independiente):
npm start

Configuración de Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

Localice el archivo de configuración de Claude Desktop:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
- Ventanas: %APPDATA%\Claude\claude_desktop_config.json
- Linux: ~/.config/Claude/claude_desktop_config.json
Agregue el servidor Lichess MCP a su configuración:
{ "mcpServers": { "lichess": { "command": "lichess-mcp", "env": { "LICHESS_TOKEN": "your-lichess-api-token", "DEBUG": "*" } } } }
Nota: Reemplace your-lichess-api-token con su token de API de Lichess. La variable de entorno DEBUG es opcional, pero útil para la resolución de problemas.
(Opcional) También puedes agregar otros servidores MCP:
{ "mcpServers": { "filesystem": { "command": "npx", "args": [ "-y", "@modelcontextprotocol/server-filesystem", "/Users/username/Desktop", "/Users/username/Downloads" ] }, "lichess": { "command": "lichess-mcp", "env": { "LICHESS_TOKEN": "your-lichess-api-token" } } } }
Reinicie Claude Desktop para aplicar los cambios.
- Asegúrese de cerrar completamente Claude Desktop (incluso desde la bandeja del sistema/barra de menú)
- Inicie Claude Desktop nuevamente
- Busque un ícono de martillo en la interfaz, que indica que los servidores MCP están conectados
Prueba la integración preguntándole a Claude sobre tu cuenta de Lichess:
- "Muéstrame mi perfil de Lichess"
- "Inicia una nueva partida de ajedrez con un control de tiempo de 10 minutos"

Solución de problemas

Si encuentra problemas con la conexión al servidor MCP:

Asegúrese de haber instalado el paquete globalmente con npm install -g
Verifique que el comando lichess-mcp esté disponible en su PATH ( which lichess-mcp )
Compruebe que su archivo de configuración tenga el formato correcto (el formato más nuevo mcpServers en lugar de mcp_servers )
Reiniciar Claude Desktop por completo
Intente habilitar el modo de desarrollador en Claude Desktop (si está disponible) para obtener registros adicionales
Verifique que su token API de Lichess sea válido