hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Provides support for loading environment variables from a .env file for configuring the Lichess API token.
Enables comprehensive interaction with the Lichess chess platform, including account management, playing chess games, creating challenges, analyzing positions, managing tournaments, joining teams, and connecting with other players.

Lichess MCP

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

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

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
Inicie 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

Referencias

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Un servidor MCP que permite la interacción en lenguaje natural con la plataforma de ajedrez Lichess, permitiendo a los usuarios jugar partidas, analizar posiciones, administrar su cuenta y participar en torneos a través de Claude.

Related Resources

Reddit Discussion about this server