🚀 Lichess MCP 说明文档

Lichess MCP 是一款借助 Model Context Protocol (MCP) 实现与 Lichess 对弈平台交互的工具。用户能够在 Claude Desktop 上通过自然语言管理棋盘游戏、分析棋局，还能执行各类对弈相关操作。

🚀 快速开始

Lichess MCP 可帮助用户在 Claude Desktop 上与 Lichess 对弈平台进行交互，实现自然语言管理棋盘游戏等功能。以下为你详细介绍配置和使用方法。

📦 安装指南

1. 安装依赖

请依照以下步骤安装所需依赖项：

npm install -g lichess-mcp

2. 环境变量配置

有两种方式可设置 Lichess API 令牌：

方法一：使用 .env 文件

在项目根目录创建一个 .env 文件，并添加以下内容，将 your-lichess-api-token 替换为你的实际 API 令牌：

LICHESS_TOKEN=your-lichess-api-token

方法二：运行时配置

在代码中通过 set_token 函数设置令牌：

const { set_token } = require('lichess-mcp');
set_token({ LICHESS_TOKEN: 'your-lichess-api-token' });

3. 构建和安装

构建项目并将其作为全局包安装：

npm install -g

4. 启动服务器（可选）

若需独立运行 MCP 服务器，可执行以下命令：

npm start

📚 详细文档

配置 Claude Desktop

要将 Lichess 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. 在配置文件中添加以下内容，将 your-lichess-api-token 替换为你的实际令牌：

   {
     "mcpServers": {
       "lichess": {
         "command": "lichess-mcp",
         "env": {
           "LICHESS_TOKEN": "your-lichess-api-token",
           "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 并确保 MCP 服务器已正确连接。界面中会显示锤子图标，表示 MCP 服务器已连接。

5. 测试：尝试让 Claude 查询你的 Lichess 资料或开始新的对弈：

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

故障排除

若遇到问题，请检查以下事项：

1. 确保已全局安装 lichess-mcp。
2. 验证 lichess-mcp 命令是否在 PATH 中可用 (which lichess-mcp)。
3. 确保配置文件格式正确，并使用 mcpServers 字段而非旧的 mcp_servers 格式。
4. 完全重启 Claude Desktop 后再次尝试。
5. 启用开发者模式以获取更多日志信息。

📄 参考资料

• Model Context Protocol
• Lichess API 文档