Liches MCP
](https://smithery.ai/server/@karayaman/lichess-mcp)
用自然语言与Lichess对话，与国际象棋平台互动。将其与Claude Desktop一起使用，可以玩游戏、分析位置和管理您的国际象棋活动。
使用 模型上下文协议.
服务器启用：
- 管理您的Lichess帐户
- 下棋和挑战
- 分析位置和游戏
- 加入锦标赛和团队
- 与其他玩家互动
配置
Liches API令牌可以通过两种方式设置：
- 环境变量：将其添加到您的
.env在项目根目录中创建文件或直接设置它：
LICHESS_TOKEN=your-lichess-api-token- 使用
set_token运行时工具：
set_token({
token: "your-lichess-api-token"
});令牌可以在以下时间生成https://lichess.org/account/oauth/token
可用工具
1.账户管理
// 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.游戏
// 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.博弈分析
// 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.锦标赛
// 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
});5.交互式用户界面（克劳德桌面）
这些工具在聊天中打开了一个真正的棋盘——拖动棋子、导航 移动并单击打开的树——使用 MCP应用程序 扩展。在没有UI支持的客户端中，每个工具都会回退到 包含FEN/PGN/Lichess链接的文本响应。
// Open today's daily puzzle (or a specific id) as an interactive solver.
play_puzzle({ puzzleId: "Bmfot" });
// Step through a Lichess game or raw PGN with prev/next/play controls.
view_pgn({ gameId: "abcd1234" });
view_pgn({ pgn: "1. e4 e5 2. Nf3 ..." });
// Walk the opening tree: click moves to drill down; toggle masters/lichess.
explore_openings({ source: "masters" });国际象棋符号
移动格式
Lichess API接受以下格式的移动：
- 加州大学欧文分校：通用国际象棋接口格式（例如。，
e2e4,g8f6) - 存储区域网络：标准代数符号（例如。，
e4,Nf6)-仅适用于某些端点
FEN格式
福赛斯·爱德华兹符号（FEN）用于表示国际象棋的位置：
rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1这代表：
- 棋子位置（从第8位到第1位）
- 活动颜色（w/b）
- 浇注可用性（KQkq）
- 途中目标广场
- 半移动时钟
- 满移动号码
错误处理
服务器为以下对象提供详细的错误消息：
- 无效的移动或位置
- 身份验证问题
- 费率限制
- 未找到资源案例
安装说明
通过史密瑟里安装
通过以下方式自动安装Liches Integration for Claude Desktop 铁匠铺:
npx -y @smithery/cli install @karayaman/lichess-mcp --client claude手动安装
- 克隆存储库：
git clone https://github.com/karayaman/lichess-mcp.git
cd lichess-mcp- 安装依赖项：
npm install- 配置环境变量：
创建一个 .env 根目录中的文件：
LICHESS_TOKEN=your-lichess-api-token- 构建项目：
npm run build- 全局安装该软件包（建议用于Claude Desktop集成）：
npm install -g- 启动服务器（用于独立使用）：
npm start配置Claude桌面
要将此MCP服务器与Claude Desktop一起使用：
- 找到您的Claude Desktop配置文件：
- macOS： ~/Library/Application Support/Claude/claude_desktop_config.json - 窗户： %APPDATA%\Claude\claude_desktop_config.json - Linux： ~/.config/Claude/claude_desktop_config.json
- 将Liches MCP服务器添加到您的配置中：
{
"mcpServers": {
"lichess": {
"command": "lichess-mcp",
"env": {
"LICHESS_TOKEN": "your-lichess-api-token",
"DEBUG": "*"
}
}
}
}注：更换 your-lichess-api-token 使用您的实际Licess API令牌。这 DEBUG 环境变量是可选的，但有助于故障排除。
- （可选）您也可以添加其他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"
}
}
}
}- 重新启动Claude Desktop以应用更改。
- 确保完全关闭Claude Desktop（包括从系统托盘/菜单栏） - 再次启动克劳德桌面 - 在界面中寻找一个锤子图标，表示MCP服务器已连接
- 通过向Claude询问您的Lichess帐户来测试集成：
- “显示我的Lichess个人资料” - “用10分钟的时间控制开始一场新的象棋游戏”
故障排除
如果遇到MCP服务器连接问题：
- 确保您已全局安装了该软件包
npm install -g - 确认
lichess-mcp命令在PATH中可用(which lichess-mcp) - 检查您的配置文件是否具有正确的格式（较新的
mcpServers格式而不是mcp_servers) - 完全重新启动克劳德桌面
- 尝试在Claude Desktop中启用开发人员模式（如果可用）以进行其他日志记录
- 验证您的Licess API令牌是否有效