Skip to main content
Glama
Sign In
enesjakozh

Lichess MCP

by karayaman
GitHub
JavaScript
MIT License
2
  • Apple
  • Linux
OverviewInspectNewSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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:

  1. 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
  2. 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

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

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

Configuración de Claude Desktop

Para utilizar este servidor MCP con Claude Desktop:

  1. 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
  2. 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.
  3. (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" } } } }
  4. 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
  5. 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:

  1. Asegúrese de haber instalado el paquete globalmente con npm install -g
  2. Verifique que el comando lichess-mcp esté disponible en su PATH ( which lichess-mcp )
  3. Compruebe que su archivo de configuración tenga el formato correcto (el formato más nuevo mcpServers en lugar de mcp_servers )
  4. Reiniciar Claude Desktop por completo
  5. Intente habilitar el modo de desarrollador en Claude Desktop (si está disponible) para obtener registros adicionales
  6. 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

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.

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.

  1. Configuración
    1. Herramientas disponibles
      1. Gestión de cuentas
      2. Jugabilidad
      3. Análisis del juego
      4. Torneos
    2. Notación de ajedrez
      1. Formatos de movimiento
      2. Formato FEN
    3. Manejo de errores
      1. Instrucciones de configuración
        1. Instalación mediante herrería
        2. Instalación manual
      2. Configuración de Claude Desktop
        1. Solución de problemas
          1. Referencias

            Related Resources

            Related MCP Servers

            • Clanki

              jasperket
              -
              security
              F
              license
              -
              quality
              An MCP server that enables AI assistants like Claude to interact with Anki flashcard decks, allowing users to create, manage, and update flashcards through natural language conversations.
              Last updated -
              1
              TypeScript

            • Game Asset Generator

              MubarakHAlketbi
              -
              security
              A
              license
              -
              quality
              An MCP server that generates 2D and 3D game assets from text prompts using AI models from Hugging Face Spaces, allowing developers to easily create game art through Claude Desktop or other MCP clients.
              Last updated -
              34
              JavaScript
              MIT License
              • Apple
              • Linux

            • Minesweeper MCP Server

              tonypan2
              -
              security
              F
              license
              -
              quality
              An MCP server that enables AI agents like Claude to play Minesweeper through natural language interaction, connecting to a separate Minesweeper game server.
              Last updated -
              80
              JavaScript

            • GOAT MCP Server

              cryptoleek-team
              -
              security
              F
              license
              -
              quality
              An MCP server that connects Claude for Desktop with blockchain functionality, allowing users to check balances and send tokens on EVM and Solana chains through natural language interactions.
              Last updated -
              TypeScript
              • Apple

            View all related MCP servers

            Appeared in Searches

            New MCP Servers

            MCP directory API

            We provide all the information about MCP servers via our MCP API.

            curl -X GET 'https://glama.ai/api/mcp/v1/servers/karayaman/lichess-mcp'

            If you have feedback or need assistance with the MCP directory API, please join our Discord server