MCP Chess

一个Model Context Protocol（MCP）服务器，为Claude AI助手提供国际象棋功能。

https://github.com/user-attachments/assets/324ed381-35f3-45b7-b877-127ef27fd97d

功能

此服务器实现了扩展Claude能力的工具：

• 根据福瑞斯特-爱德华兹符号（FEN）字符串生成国际象棋棋盘图像
• 在国际象棋游戏中建议下一步行动
• 检查移动是否合法

Claude桌面版安装

1. 从发布页面下载最新二进制文件：

   • 对于Windows：mcp-chess-windows.exe
   • 对于macOS：mcp-chess-darwin
   • 对于Linux：mcp-chess-linux

2. 将文件设置为可执行（仅限macOS/Linux）：

   chmod +x mcp-chess-darwin   # 对于macOS
   chmod +x mcp-chess-linux    # 对于Linux
   

3. 对于macOS用户 - 跳过安全警告：

   当您首次尝试运行应用程序时，macOS可能会显示安全警告，因为该应用程序未由已识别的开发者签名。要跳过此警告：

   • 右键点击（或Control点击）mcp-chess-darwin文件
   • 从上下文菜单中选择“打开”
   • 点击出现的对话框中的“打开”

   或者，您可以使用终端：

   xattr -d com.apple.quarantine /path/to/mcp-chess-darwin
   

   这只需要做一次。

4. 配置Claude桌面版：

   • 打开Claude桌面版
   • 选择“设置”，并点击“开发者”标签页
   • 点击“编辑配置”
   • 添加MCP服务器配置
   • 保存文件
   • 重启Claude桌面版

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

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

使用Claude

一旦正确配置，您可以要求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许可证2.0进行许可 - 详情见LICENSE文件。

致谢

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