Stockfish MCP (Stepbot)

Stockfish MCP服务器

用于模型上下文协议的Stockfish服务器。此软件包允许大型语言模型与Stockfish引擎下棋。

安装

此包是一个纯Python包装器，要求您提供自己的Stockfish二进制文件。

1. 下载Stockfish： 从以下位置获取适合您系统的版本 Stockfish官方网站.

1. 安装MCP服务器： 我们建议使用 uv 安装该软件包。第一， 安装 uv。然后，运行以下命令进行安装 stockfish-mcp 作为一个全局可用的命令行工具，它位于自己的隔离环境中：

   uv tool install stockfish-mcp

用法

有两种方法可以运行服务器：

1.命令行

您可以直接运行服务器，提供下载的Stockfish可执行文件的路径。

uv tool run stockfish-mcp --stockfish-path C:\path\to\your\stockfish.exe

2.MCP配置

或者，您可以将其添加到MCP中 settings.json 文件。这对于与MCP VS Code扩展等客户端集成非常有用。

{
    "mcpServers": {
        "stockfish": {
            "command": "uv",
            "args": ["tool", "run", "stockfish-mcp", "--stockfish-path", "C:\\path\\to\\your\\stockfish.exe"]
        }
    }
}

示例

与Stockfish引擎对抗的游戏示例可以在 exampleGame.md.

可用工具

• get_board_state()：获取当前板状态。
• make_move(move_uci: str)：采取行动（例如，“e2e4”）。
• is_game_over()：检查游戏是否已结束。
• get_game_result()：如果游戏结束，就得到结果。
• reset_game(skill_level: int = 10)：开始一个新游戏。