chess-uci-mcp

Name: chess-uci-mcp
Author: AnglerfishChess

@AnglerfishChess

代码仓库

关于 chess-uci-mcp

MCP server to connect to the chess engines using UCI protocol

#python #chess-engine #chess #mcp #uci #claude #uci-engine #uci-chess-engine #claude-ai #mcp-server

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

AnglerfishChess

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "chess-uci-mcp": {
      "command": "uv",
      "args": [
        "venv",
        "--python",
        "python3.10"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is chess-uci-mcp?

An MCP bridge that provides an interface to UCI chess engines (such as Stockfish) for use with MCP-compatible AI clients like Claude Desktop. It is intended for developers or chess enthusiasts who want to integrate chess analysis capabilities into LLM workflows.

How to use chess-uci-mcp?

Requires Python 3.10 or newer, uv/uvx, and a UCI-compatible chess engine binary (e.g., Stockfish). Configure it in your MCP client settings (e.g., claude_desktop_config.json) using either uvx (recommended) or uv commands, specifying the engine path and optional UCI options with -o. Run the server by launching the client; commands are invoked via MCP tools.

Key features of chess-uci-mcp

Bridges MCP with any UCI-compatible chess engine
Supports configurable UCI options (e.g., Threads, Hash)
Provides chess analysis via FEN strings
Offers best‑move retrieval for a given position
Allows setting the current board position explicitly
Reports engine details and supports debug logging

Use cases of chess-uci-mcp

Let an AI assistant analyze a chess position and return best moves
Integrate real‑time chess engine evaluation into chat interfaces
Automate chess puzzle solving or game analysis with LLMs
Build chess‑teaching tools that connect users to Stockfish via natural language

FAQ from chess-uci-mcp

Which chess engines are supported?

Any engine that implements the UCI protocol. Stockfish (tested with version 17) is recommended; you can install it via brew install stockfish on macOS or download from stockfishchess.org.

How do I pass options like Threads or Hash to the engine?

Use the -o flag followed by the option name and value (e.g., -o Threads 4 -o Hash 128) in the command arguments of your MCP configuration.

What MCP commands does the bridge provide?

It provides analyze (analyze a FEN position), get_best_move, set_position, and engine_info (get engine information).

Can I change the engine's thinking time?

Yes. Use the --think-time command-line option, which sets the default thinking time in milliseconds (default: 1000).

Are there any runtime dependencies besides Python and the engine?

You need uv or uvx installed. The server runs locally and does not require an internet connection or authentication.

其他分类下的更多 MCP 服务器

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K