JinDaGe - chess-uci-mcp MCP Details

article

README

🚀 国际象棋-UCI-MCP

国际象棋-UCI-MCP 是一个 MCP 桥接器，它能提供与 UCI 国际象棋引擎（如 Stockfish）的接口，帮助用户更便捷地使用国际象棋引擎进行相关操作。

🚀 快速开始

要使用国际象棋 - UCI - MCP，您需要完成以下准备工作：

安装 Python 3.10 或更高版本。
安装uv/uvx。
安装一个兼容 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 命令：

analyze - 分析由 FEN 字符串指定的国际象棋位置
get_best_move - 获取某个国际象棋位置的最佳移动
set_position - 设置当前国际象棋位置
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

chess-uci-mcp