Lichess MCP服务器使用说明

项目简介

Lichess MCP服务器是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在让用户能够通过自然语言与 Lichess 国际象棋平台进行交互。它允许用户使用支持 MCP 协议的客户端（如 Claude Desktop）以自然语言指令完成在 Lichess 上的各种操作，例如下棋、分析棋局、管理账户、参与比赛等。

主要功能点

账户管理: 设置和获取Lichess API令牌，查看个人资料和用户资料，管理儿童模式等。
游戏对弈: 创建挑战，接受/拒绝挑战，在游戏中走棋，处理和局提议，认输，获取当前对局信息。
棋局分析: 导出棋局为 PGN 格式，获取棋局的云端分析。
赛事参与: 查看和加入锦标赛，创建新的锦标赛。
社交互动: 关注/取消关注用户，屏蔽用户，发送私信，添加用户备注。
数据获取: 获取用户比赛记录、等级分历史、活跃度、排行榜等数据。

安装步骤

克隆仓库:

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

安装依赖:
```
npm install
```
配置环境变量:
- 在项目根目录下创建 '.env' 文件，并添加您的 Lichess API 令牌。您可以在 https://lichess.org/account/oauth/token 生成令牌。
```
LICHESS_TOKEN=your-lichess-api-token
```
构建项目:
```
npm run build
```
全局安装 (推荐):
```
npm install -g
```

服务器配置

要将 Lichess MCP 服务器配置到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加以下 JSON 配置。请注意，MCP客户端不需要启动参数，只需要服务器的启动命令 'lichess-mcp'，客户端会自动调用该命令来启动MCP服务器。

{
  "mcpServers": {
    "lichess": {
      "command": "lichess-mcp"
    }
  }
}

配置参数说明:

'server name': 'lichess' (服务器名称，可以自定义，用于在客户端中标识和调用)
'command': '"lichess-mcp"' (启动服务器的命令，全局安装后可以直接使用 'lichess-mcp')

Claude Desktop 配置示例:

不同操作系统下的 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'

在 'claude_desktop_config.json' 文件中，将上述 JSON 配置添加到 'mcpServers' 字段中，例如：

{
  "mcpServers": {
    "lichess": {
      "command": "lichess-mcp"
    }
  }
}

基本使用方法

确保已按照安装步骤完成服务器的安装和配置。
启动您的 MCP 客户端 (如 Claude Desktop)。
在客户端中，您可以使用自然语言指令与 Lichess 平台互动。例如：
- "Show me my Lichess profile" (显示我的 Lichess 个人资料)
- "Start a new chess game with player [用户名] with 10 minutes time control" (与 [用户名] 开始一局 10 分钟时限的国际象棋对局)
- "Analyze the current chess position" (分析当前的棋局)
- "What are my ongoing chess games?" (我有哪些正在进行的棋局？)

注意: 首次使用时，您可能需要使用 'set_token' 工具设置您的 Lichess API 令牌。某些工具可能需要您提供用户名、棋局ID等参数。请参考仓库 README.md 文件中 "Available Tools" 部分的工具说明和示例。

关键词