Lichess MCP
2025.03.11
2
JavaScript国际象棋平台自然语言交互娱乐功能
Lichess MCP 是一个基于自然语言交互的国际象棋平台服务，允许用户通过自然语言与 Lichess 平台进行交互。用户可以通过 Claude Desktop 进行游戏、分析棋局以及管理国际象棋活动。该服务基于 Model Context Protocol 构建，提供了丰富的功能来增强用户的国际象棋体验。
View on GitHub
Overview
基本能力
产品定位
Lichess MCP 是一个国际象棋平台的自然语言交互接口，旨在通过自然语言简化用户与 Lichess 平台的交互过程。
核心功能
- 账户管理：获取用户个人资料和其他用户资料。
- 游戏对战：创建挑战、进行移动、获取进行中的游戏。
- 棋局分析：导出游戏（PGN格式）、获取云评估。
- 锦标赛：列出当前锦标赛、加入或创建新锦标赛。
- 错误处理：提供详细的错误消息，包括无效移动、认证问题、速率限制等。
适用场景
- 通过自然语言管理 Lichess 账户。
- 进行国际象棋游戏和对战。
- 分析和评估棋局。
- 参与或组织国际象棋锦标赛。
工具列表
- Account Management：管理 Lichess 账户，包括设置 API token 和获取用户资料。
- Game Play：创建挑战、进行移动、获取进行中的游戏。
- Game Analysis：导出游戏（PGN格式）、获取云评估。
- Tournaments：列出、加入或创建锦标赛。
常见问题解答
- API Token 设置：可以通过环境变量或运行时设置。
- 错误处理：提供详细的错误消息帮助调试。
- Claude Desktop 配置：需要正确配置 MCP 服务器并重启 Claude Desktop。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 克隆仓库并安装依赖：
bash git clone https://github.com/karayaman/lichess-mcp.git cd lichess-mcp npm install
安装教程
- 配置环境变量：
bash LICHESS_TOKEN=your-lichess-api-token - 构建项目：
bash npm run build - 全局安装（推荐）：
bash npm install -g - 启动服务器（独立使用）：
bash npm start
调试方式
- 确保
lichess-mcp命令在 PATH 中：bash which lichess-mcp - 检查配置文件格式是否正确。
- 重启 Claude Desktop 并测试集成。
- 启用开发者模式获取额外日志。
- 验证 Lichess API token 是否有效。