MCP 服务器

chess-uci-mcp

使用 UCI 协议连接到国际象棋引擎的 MCP 服务器

AnglerfishChess

开发者工具

访问服务器

README

chess-uci-mcp

一个提供与 UCI 国际象棋引擎（例如 Stockfish）接口的 MCP 桥接器。

依赖

你需要 Python 3.10 或更高版本，并且安装了 uv/uvx。

用法

要运行，它需要安装一个兼容 UCI 的国际象棋引擎，例如 Stockfish（已使用 Stockfish 17 进行测试）。

如果是 Stockfish，你可以从 https://stockfishchess.org/download/ 下载。

在 macOS 上，你可以使用 brew install stockfish。

你需要找出你的 UCI 引擎二进制文件的路径；例如，对于进一步的配置，路径可能是 /usr/local/bin/stockfish（这是使用 Brew 在 macOS 上安装的 Stockfish 的默认路径）。

进一步的配置应该在你的 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": "uv",
    "args": ["--from=git+https://github.com/AnglerfishChess/chess-uci-mcp", "chess-uci-mcp", "/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/AnglerfishChess/chess-uci-mcp.git
# ... 或者
#    git clone git@github.com:AnglerfishChess/chess-uci-mcp.git

cd chess-uci-mcp

# 创建一个虚拟环境
uv venv --python python3.10

# 激活虚拟环境
source .venv/bin/activate  # 在 Unix/macOS 上
# 或者
.venv\Scripts\activate     # 在 Windows 上

# 以开发模式安装软件包
#    uv pip install -e .
# 或者，使用开发依赖项
uv pip install -e ".[dev]"

# 运行测试
pytest

# 检查代码风格
ruff check