
MCP Chess

2025.03.05
6
Java国际象棋AI助手扩展娱乐功能
MCP Chess 是一个基于 Model Context Protocol (MCP) 的服务,专为 Claude AI 助手设计,提供国际象棋相关的功能。它能够生成国际象棋棋盘图像、建议下一步棋以及检查棋步的合法性。
View on GitHub
Overview
基本能力
产品定位
MCP Chess 是一个为 Claude AI 助手设计的国际象棋功能扩展服务,旨在通过 MCP 协议增强 Claude 在国际象棋方面的能力。
核心功能
- 从 Forsyth-Edwards Notation (FEN) 字符串生成国际象棋棋盘图像
- 在国际象棋游戏中建议下一步棋
- 检查棋步是否合法
适用场景
- 与 Claude AI 进行国际象棋游戏
- 学习国际象棋策略和规则
- 生成国际象棋棋盘图像用于教学或演示
工具列表
- ChessGame: Java 国际象棋库,用于处理国际象棋规则和逻辑
- ChessImage: 国际象棋棋盘渲染器,用于生成棋盘图像
- Stockfish.online: 国际象棋引擎 API,用于计算最佳棋步
- Spring AI: AI 应用框架,用于实现 MCP 服务器
常见问题解答
- macOS 安全警告: 首次运行时可能需要绕过 macOS 的安全警告,可以通过右键点击文件选择“打开”或使用终端命令
xattr -d com.apple.quarantine /path/to/mcp-chess-darwin
解决。 - 配置 Claude Desktop: 需要在 Claude Desktop 的开发者设置中添加 MCP 服务器配置,并指定二进制文件的路径。
使用教程
使用依赖
- 需要安装 Java 21 和 GraalVM 以从源代码构建项目。
安装教程
- 从 Releases 页面下载最新二进制文件:
- Windows:
mcp-chess-windows.exe
- macOS:
mcp-chess-darwin
-
Linux:
mcp-chess-linux
-
使文件可执行(仅 macOS/Linux):
bash chmod +x mcp-chess-darwin # for macOS chmod +x mcp-chess-linux # for Linux
-
配置 Claude Desktop:
- 打开 Claude Desktop
- 选择“Settings”,点击“Developer”标签
- 点击“Edit Config”
- 添加 MCP 服务器配置
- 保存文件并重启 Claude Desktop
示例配置:
json
{
"mcpServers": {
"mcp-chess": {
"command": "/path/to/mcp-chess-binary"
}
}
}
调试方式
- 从源代码构建项目:
bash git clone https://github.com/alexandreroman/mcp-chess.git cd mcp-chess ./mvnw clean package ./mvnw -Pnative native:compile
- 运行二进制文件并检查日志输出以调试问题。