Chess Uci MCP

🚀 國際象棋-UCI-MCP

國際象棋-UCI-MCP 是一個 MCP 橋接器，它能提供與 UCI 國際象棋引擎（如 Stockfish）的接口，幫助用戶更便捷地使用國際象棋引擎進行相關操作。

🚀 快速開始

要使用國際象棋 - UCI - MCP，您需要完成以下準備工作：

1. 安裝 Python 3.10 或更高版本。
2. 安裝uv/uvx。
3. 安裝一個兼容 UCI 的國際象棋引擎，例如 Stockfish（已與 Stockfish 17 進行了測試）。

📦 安裝指南

安裝國際象棋引擎

• 下載安裝：對於 Stockfish，可以從這裡下載。
• macOS 安裝：在 macOS 上，可以使用以下命令進行安裝：

brew install stockfish

查找二進制文件路徑

您需要找到 UCI 功能支持的二進制文件路徑。例如，默認情況下，Stockfish 在 macOS 通過 Brew 安裝後，路徑為/usr/local/bin/stockfish。

配置 MCP 設置

進一步配置需在 MCP 設置中完成。對於 Claude Desktop，這是文件claude_desktop_config.json（可以在設置菜單的開發者部分找到並編輯）。不同操作系統下的完整路徑如下：

• macOS：~/Library/Application\ Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%/Claude/claude_desktop_config.json
• Linux：~/.config/Claude/claude_desktop_config.json

選擇運行方式並配置 MCP

Uvx（推薦）

Uvx 可以直接按名稱運行 Python 應用程序，確保所有依賴關係，並在自動創建的虛擬環境中運行。這是運行chess-uci-mcp橋接器的推薦方法。設置您的 MCP 服務器配置文件（例如 Claude Desktop 配置）如下所示：

"mcpServers": {
  "chess-uci-mcp": {
    "command": "uvx",
    "args": ["chess-uci-mcp@latest", "/usr/local/bin/stockfish"]
  }
}

Uv

如果本地克隆了倉庫並從其運行，請使用以下方式：

"mcpServers": {
  "chess-uci-mcp": {
    "command": "uv",
    "args": ["run", "chess-uci-mcp", "/usr/local/bin/stockfish"]
  }
}

💻 使用示例

可用的 MCP 命令

該橋接器提供以下 MCP 命令：

1. analyze - 分析由 FEN 字符串指定的國際象棋位置
2. get_best_move - 獲取某個國際象棋位置的最佳移動
3. set_position - 設置當前國際象棋位置
4. engine_info - 獲取關於國際象棋引擎的信息

🔧 開發

克隆倉庫

git clone https://github.com/Angel100800/Chess-UCI-MCP.git

創建虛擬環境並安裝依賴

uv create && uv install

啟動開發服務器

npm run dev

測試

npm test

構建項目

npm run build

提交代碼

git add .
git commit -m "your message"
git push

🚀 發佈

創建新版本

npm version patch

推送更新到 GitHub 和 npm

git push --follow-tags
npm publish

📄 許可證

本項目採用MIT 許可證。

👨‍💻 項目維護者

@Angel100800