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 应用程序框架