JinDaGe - mcp-chess MCP Details

article

README

🚀 MCP 国际象棋服务器

MCP 国际象棋服务器是一个基于 Model Context Protocol (MCP) 的服务器，它为 Claude AI 助手赋予了强大的国际象棋功能，让用户能够在 Claude AI 中轻松进行国际象棋相关的操作。

点击查看相关视频

✨ 主要特性

此服务器作为扩展 Claude 能力的有力工具，具备以下实用功能：

能够根据 Forsyth-Edwards Notation (FEN) 字符串生成直观的国际象棋棋盘图像。
可针对国际象棋游戏给出下一步的走法建议。
能实时检查某一具体走法是否合法。

📦 安装指南

在 Claude Desktop 上的安装步骤

下载二进制文件：从 Releases 页面下载最新的二进制文件，根据不同的操作系统选择对应的文件：
- Windows 系统：mcp-chess-windows.exe
- macOS 系统：mcp-chess-darwin
- Linux 系统：mcp-chess-linux
赋予可执行权限（仅 macOS/Linux 系统需要）：打开终端，分别执行以下命令：
```
chmod +x mcp-chess-darwin   # 对于 macOS
chmod +x mcp-chess-linux    # 对于 Linux
```
macOS 用户处理安全警告：当首次尝试运行该应用程序时，macOS 可能会因应用未由已识别的开发人员签名而显示安全警告。可通过以下两种方式解决：
- 图形界面操作：右键（或 Control-click）点击 mcp-chess-darwin 文件，在上下文菜单中选择“打开”，然后在弹出的对话框中点击“打开”。
- 终端命令操作：在终端中执行以下命令：
```
xattr -d com.apple.quarantine /path/to/mcp-chess-darwin
```
此操作仅需进行一次。
配置 Claude Desktop：
- 打开 Claude Desktop。
- 选择“设置”，然后点击“开发者”选项卡。
- 点击“编辑配置”。
- 添加 MCP 服务器配置。
- 保存配置文件。
- 重新启动 Claude Desktop。

以下是 MCP 服务器配置的示例：

{
  "mcpServers": {
    "mcp-chess": {
      "command": "/path/to/mcp-chess-binary"
    }
  }
}

💻 使用示例

基础用法

配置完成后，你可以向 Claude 发送各种国际象棋相关的指令，例如：

显示一个国际象棋游戏的初始位置。

让我们开始一盘棋。检查每个走法是否合法。建议下一步最佳走法。

Nf3 是从初始位置出发的合法走法吗？

在以下位置： "rnbqkbnr/pppp1ppp/8/4p3/4P3/8/PPPP1PPP/RNBQKBNR w KQkq - 0 2"，白方有什么好的走法？

🔧 技术细节

开发技术栈

该项目采用了以下先进技术构建：

Spring Boot
Spring AI（用于 MCP 服务器实现）
Java 21
GraalVM 原生编译

从源代码构建

# 克隆仓库
git clone https://github.com/alexandreroman/mcp-chess.git
cd mcp-chess

# 使用 Maven 构建
./mvnw clean package

# 构建原生可执行文件
./mvnw -Pnative native:compile

📄 许可证

该项目遵循 Apache License 2.0 许可证发布，有关详细信息，请参阅 LICENSE 文件。

🔗 参考项目

ChessGame - Java 国际象棋库
ChessImage - 国际象棋棋盘渲染器
Stockfish.online - 国际象棋引擎 API
Spring AI - AI 应用程序框架

mcp-chess