MCP Stockfish

🚀 mcp-stockfish 🐟

mcp-stockfish 是一個模型上下文協議（MCP）服務器，它能讓你的人工智能與 Stockfish 國際象棋引擎進行通信。有了它，我們的人工智能就能更便捷地使用國際象棋引擎了。

🧠⚡🖥️ 大語言模型負責思考，Stockfish 負責計算，而你只需假裝理解那長達 15 步的戰術序列。

🚀 快速開始

安裝

git clone https://github.com/sonirico/mcp-stockfish
cd mcp-stockfish
make install

使用

# 默認模式（標準輸入輸出，老派做法）
mcp-stockfish

# 指定 Stockfish 路徑（適合有特殊需求的用戶）
MCP_STOCKFISH_PATH=/your/special/stockfish mcp-stockfish

# HTTP 模式（適合處理大規模網絡請求的場景）
MCP_STOCKFISH_SERVER_MODE=http mcp-stockfish

✨ 主要特性

• 🔄 併發會話：可同時運行多個 Stockfish 實例，而不會讓你的 CPU 不堪重負。
• ⚡ 全面支持 UCI：提供你所需的所有命令，摒棄無用的冗餘命令。
• 🎯 穩定可靠：與你之前的業餘項目不同，本項目具備完善的錯誤處理機制。
• 📊 全 JSON 格式：如今似乎大家都不再滿足於純文本格式了。
• 🐳 支持 Docker：採用容器化部署，以防你不小心搞壞本地環境。

📦 安裝指南

git clone https://github.com/sonirico/mcp-stockfish
cd mcp-stockfish
make install

💻 使用示例

基礎用法

# 默認模式（標準輸入輸出，老派做法）
mcp-stockfish

高級用法

# 指定 Stockfish 路徑（適合有特殊需求的用戶）
MCP_STOCKFISH_PATH=/your/special/stockfish mcp-stockfish

# HTTP 模式（適合處理大規模網絡請求的場景）
MCP_STOCKFISH_SERVER_MODE=http mcp-stockfish

📚 詳細文檔

支持的 UCI 命令 ♟️

配置 ⚙️

服務器配置

• MCP_STOCKFISH_SERVER_MODE："stdio" 或 "http"（默認："stdio"）
• MCP_STOCKFISH_HTTP_HOST：HTTP 主機（默認："localhost"）
• MCP_STOCKFISH_HTTP_PORT：HTTP 端口（默認：8080）

Stockfish 🐟 配置

• MCP_STOCKFISH_PATH：Stockfish 二進制文件路徑（默認："stockfish"）
• MCP_STOCKFISH_MAX_SESSIONS：最大併發會話數（默認：10）
• MCP_STOCKFISH_SESSION_TIMEOUT：會話超時時間（默認："30m"）
• MCP_STOCKFISH_COMMAND_TIMEOUT：命令超時時間（默認："30s"）

日誌記錄

• MCP_STOCKFISH_LOG_LEVEL：調試、信息、警告、錯誤、致命錯誤
• MCP_STOCKFISH_LOG_FORMAT：json、console
• MCP_STOCKFISH_LOG_OUTPUT：stdout、stderr

工具參數

• command：要執行的 UCI 命令
• session_id：會話 ID（可選，若未提供，系統會自動生成）

響應格式

{
  "status": "success|error", 
  "session_id": "some-uuid",
  "command": "what you asked for",
  "response": ["what stockfish said"],
  "error": "what went wrong (if anything)"
}

會話管理

會話功能符合你的預期：

• 根據需求啟動 Stockfish 進程
• 在命令之間保持 UCI 狀態
• 在會話結束（或超時）時進行清理
• 實施限制，防止出現進程爆炸的情況

集成

Claude 桌面端

{
  "mcpServers": {
    "chess": {
      "command": "mcp-stockfish",
      "env": {
        "MCP_STOCKFISH_LOG_LEVEL": "info"
      }
    }
  }
}

開發

make deps     # 獲取依賴項
make build    # 構建項目
make test     # 運行測試（如果有的話）
make fmt      # 格式化代碼

鳴謝 🐟

本項目由 Stockfish 提供支持，這是一款比我們所有人加起來都強大的國際象棋引擎。感謝那些真正懂棋的開發者創建了它，而不是像這個包裝器的開發者一樣。

感謝以下項目和工具：

• Stockfish 團隊 開發瞭如此出色的國際象棋引擎。
• MCP SDK for Go 處理協議相關事務，讓我們無需操心。
• 咖啡，提神利器。

📄 許可證

本項目採用 MIT 許可證，你可以隨意使用，但出了問題可別來找我。