Lichess MCP

使用自然语言与 Lichess 交互，从而与该国际象棋平台互动。将其与 Claude Desktop 结合使用，可以进行对弈、分析局面以及管理您的国际象棋活动。

基于 Model Context Protocol 构建。

<a href="https://glama.ai/mcp/servers/x7iuw37s1v"> <img width="380" height="200" src="https://glama.ai/mcp/servers/x7iuw37s1v/badge" alt="Lichess MCP server" /> </a>

该服务器支持：

• 管理您的 Lichess 帐户
• 进行国际象棋对弈和挑战
• 分析局面和棋局
• 加入比赛和团队
• 与其他玩家互动

配置

Lichess API 令牌可以通过两种方式设置：

1. 环境变量：将其添加到项目根目录下的 .env 文件中，或直接设置：

   LICHESS_TOKEN=your-lichess-api-token
   

2. 在运行时使用 set_token 工具：

   set_token({
     token: "your-lichess-api-token"
   });
   

令牌可以在 https://lichess.org/account/oauth/token 生成

可用工具

1. 帐户管理

// 设置您的 Lichess API 令牌
set_token({
  token: "your-lichess-api-token"
});

// 获取您的 Lichess 个人资料
get_my_profile();

// 获取另一个用户的个人资料
get_user_profile({
  username: "player_name",
  trophies: true  // 包括奖杯，可选
});

2. 游戏对弈

// 向另一位玩家发起挑战
create_challenge({
  username: "opponent_username",
  timeControl: "10+0",  // 10 分钟，无增时
  color: "random"       // 或 "white", "black"
});

// 在游戏中走一步棋
make_move({
  gameId: "abcd1234",
  move: "e2e4",
  offeringDraw: false
});

// 获取您正在进行的游戏
get_ongoing_games({
  nb: 10  // 要获取的游戏数量
});

3. 棋局分析

// 以 PGN 格式导出游戏
export_game({
  gameId: "abcd1234",
  clocks: true,
  evals: true
});

// 获取位置的云评估
get_cloud_eval({
  fen: "rnbqkbnr/ppp1pppp/8/3p4/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2"
});

4. 比赛

// 列出当前的比赛
get_arena_tournaments();

// 加入比赛
join_arena({
  tournamentId: "abc123"
});

// 创建一个新的比赛
create_arena({
  name: "My Tournament",
  clockTime: 3,
  clockIncrement: 2,
  minutes: 45
});

国际象棋记谱法

走法格式

Lichess API 接受以下格式的走法：

• UCI: 通用国际象棋界面格式（例如，e2e4，g8f6）
• SAN: 标准代数记谱法（例如，e4，Nf6）- 仅适用于某些端点

FEN 格式

Forsyth-Edwards 符号 (FEN) 用于表示国际象棋局面：

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

这表示：

• 棋子位置（从第 8 行到第 1 行）
• 主动方颜色 (w/b)
• 易位可用性 (KQkq)
• 吃过路兵目标格
• 半步数
• 全步数

错误处理

服务器提供详细的错误消息，用于：

• 无效的走法或位置
• 身份验证问题
• 速率限制
• 找不到资源的情况

安装说明

1. 克隆存储库：

   git clone https://github.com/karayaman/lichess-mcp.git
   cd lichess-mcp
   

2. 安装依赖项：

   npm install
   

3. 配置环境变量： 在根目录中创建一个 .env 文件：

   LICHESS_TOKEN=your-lichess-api-token
   

4. 构建项目：

   npm run build
   

5. 全局安装软件包（推荐用于 Claude Desktop 集成）：

   npm install -g
   

6. 启动服务器（用于独立使用）：

   npm start
   

配置 Claude Desktop

要将此 MCP 服务器与 Claude Desktop 结合使用：

1. 找到您的 Claude Desktop 配置文件：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 将 Lichess MCP 服务器添加到您的配置中：

   {
     "mcpServers": {
       "lichess": {
         "command": "lichess-mcp",
         "env": {
           "LICHESS_TOKEN": "your-lichess-api-token",
           "DEBUG": "*"
         }
       }
     }
   }
   

   注意：将 your-lichess-api-token 替换为您实际的 Lichess API 令牌。 DEBUG 环境变量是可选的，但有助于进行故障排除。

3. （可选）您也可以添加其他 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. 重新启动 Claude Desktop 以应用更改。

   • 确保完全关闭 Claude Desktop（包括从系统托盘/菜单栏中关闭）
   • 再次启动 Claude Desktop
   • 在界面中查找锤子图标，表示 MCP 服务器已连接

5. 通过询问 Claude 关于您的 Lichess 帐户来测试集成：

   • "Show me my Lichess profile"
   • "Start a new chess game with 10 minutes time control"

故障排除

如果您在 MCP 服务器连接方面遇到问题：

1. 确保您已使用 npm install -g 全局安装了该软件包
2. 验证 lichess-mcp 命令在您的 PATH 中是否可用 (which lichess-mcp)
3. 检查您的配置文件是否具有正确的格式（较新的 mcpServers 格式而不是 mcp_servers）
4. 完全重新启动 Claude Desktop
5. 尝试在 Claude Desktop 中启用开发者模式（如果可用）以获取其他日志记录
6. 验证您的 Lichess API 令牌是否有效

参考

• Model Context Protocol
• Lichess API 文档