🚀 国际象棋-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 许可证。