MCP Chess

MCP Chess

site icon
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 以从源代码构建项目。

安装教程

  1. Releases 页面下载最新二进制文件:
  2. Windows: mcp-chess-windows.exe
  3. macOS: mcp-chess-darwin
  4. Linux: mcp-chess-linux

  5. 使文件可执行(仅 macOS/Linux): bash chmod +x mcp-chess-darwin # for macOS chmod +x mcp-chess-linux # for Linux

  6. 配置 Claude Desktop:

  7. 打开 Claude Desktop
  8. 选择“Settings”,点击“Developer”标签
  9. 点击“Edit Config”
  10. 添加 MCP 服务器配置
  11. 保存文件并重启 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
  • 运行二进制文件并检查日志输出以调试问题。

许可证

该项目遵循 Apache-2.0 开源许可条款,请参阅 Apache-2.0 了解完整条款。