MCP Chess

🚀 MCP 国际象棋服务器

MCP 国际象棋服务器是一个借助 Model Context Protocol (MCP) 构建的服务器，专门为 Claude AI 助手赋予国际象棋功能。它能让 Claude AI 在国际象棋领域发挥更强大的作用，为用户带来更丰富的国际象棋交互体验。

✨ 主要特性

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

• 从 Forsyth-Edwards Notation (FEN) 字符串生成国际象棋棋盘图像。
• 建议国际象棋游戏中的下一步棋。
• 检查一个走法是否合法。

📦 安装指南

在 Claude Desktop 上的安装

1. 下载最新二进制文件： 从 Releases 页面下载适合你操作系统的最新二进制文件：

   • 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-click）点击 mcp-chess-darwin 文件，选择“打开”上下文菜单中的选项，然后点击对话框中出现的“打开”。
   • 终端操作：在终端中执行以下命令：

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

   此操作只需进行一次。

4. 配置 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 应用程序框架