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