Chess Uci MCP Server

@AnglerfishChess

Repository

Basic information

About Chess Uci MCP Server

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

Chess Uci MCP Server config

Add this server to your MCP-compatible client using the configuration below.

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

Chess Uci MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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

Frequently asked questions

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.

Comments

More Other MCP servers

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

The Living Bread

A free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w

YOUB

Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K