Chess MCP服务器使用说明

项目简介

Chess MCP服务器 (chess-mcp) 是一个基于 Model Context Protocol (MCP) 构建的应用后端，旨在为大型语言模型（LLM）客户端提供专业的国际象棋分析能力。通过集成强大的 Stockfish 引擎和 Lichess 大师对局数据库，该服务器能够响应客户端的请求，提供棋局评估、最佳招法建议、可视化棋盘图像以及大师对局数据查询等功能，从而增强 LLM 在国际象棋领域的应用能力。

主要功能点

棋局分析: 使用 Stockfish 引擎评估当前棋局，提供局面评分和最佳招法建议。
可视化棋盘: 生成当前棋局的可视化图像，方便用户直观理解棋盘状态。
大师对局数据库查询: 查询 Lichess 大师对局数据库，检索特定局面下的历史对局数据，包括胜负统计、常用招法和近期大师对局信息。
走法验证: 验证用户输入的棋步是否合法，并返回执行该步后的新局面。

安装步骤

安装 Claude Desktop (如果尚未安装): Chess MCP服务器主要为 Claude 桌面客户端设计，请确保已安装 Claude Desktop。
安装 Node.js (版本 20 或更高): Chess MCP服务器基于 Node.js 开发，请确保系统中已安装 Node.js 20 或更高版本。您可以从 Node.js官网下载安装。
安装 Stockfish 引擎: Chess MCP服务器依赖 Stockfish 引擎进行棋局分析，请从 Stockfish官网下载 Stockfish 引擎，并将其添加到系统环境变量 'PATH' 中，确保可以在命令行中直接运行 'stockfish' 命令。
安装 Cairo 图形库: Cairo 用于生成棋盘图像，根据您的操作系统，可能需要安装 Cairo 图形库。具体安装步骤请参考 node-canvas 文档。
安装 Chess MCP服务器: 打开终端或命令提示符，运行以下命令全局安装 Chess MCP服务器：
```
npm install -g chess-mcp
```

服务器配置

要将 Chess MCP服务器连接到 MCP 客户端（例如 Claude Desktop），您需要配置客户端的 MCP 服务器设置。以 Claude Desktop 为例，您需要编辑 Claude Desktop 的配置文件 'claude_desktop_config.json'。

找到配置文件:
- macOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
- Windows: '%APPDATA%/Claude/claude_desktop_config.json'

添加服务器配置: 在 'claude_desktop_config.json' 文件中，找到 '"mcpServers"' 字段（如果不存在则创建），并添加 Chess MCP服务器的配置信息。配置信息是一个 JSON 对象，示例如下：

{
    "mcpServers": {
        "chess": {  // 服务器名称，可以自定义，例如 "chess"
            "command": "npx", // 启动服务器的命令，这里使用 npx 执行 npm 包
            "args": ["chess-mcp"] // 启动服务器命令的参数，这里指定运行 chess-mcp 包
        }
    }
}

配置说明:

'"chess"': 是您为该 Chess MCP服务器自定义的名称，在客户端中用于标识和调用该服务器。
'"command": "npx"': 指定用于启动服务器的命令为 'npx'，'npx' 用于执行本地或全局安装的 npm 包。
'"args": ["chess-mcp"]': 指定 'npx' 命令的参数为 '["chess-mcp"]'，即运行全局安装的 'chess-mcp' npm 包，这会启动 Chess MCP服务器。

保存并重启 Claude Desktop: 保存 'claude_desktop_config.json' 文件，并重启 Claude Desktop 使配置生效。

基本使用方法

配置完成后，在 Claude Desktop 中，您应该能够看到 Chess MCP服务器提供的国际象棋分析工具。您可以通过自然语言提示词来调用这些工具，例如：

"分析这个棋局: rnbqkbnr/pppppppp/8/8/8/8/PPPPPPPP/RNBQKBNR w KQkq - 0 1" (请求棋局评估)
"显示当前棋局" (请求生成棋盘图像)
"最佳招法是什么？" (请求最佳招法建议)
"在这个局面下查询大师对局" (请求大师对局数据库查询)
"展示这个局面下大师们在2000年后的对局" (带时间范围的大师对局查询)
"大师们在这个局面下最常走的招法是什么？" (请求常用招法)

具体工具的使用方法和参数，请参考 MCP 客户端 (如 Claude Desktop) 的工具列表或相关文档。

关键词