Advertise
MCP.so
Sign In

Chess Uci MCP Server

@AnglerfishChess

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

AnglerfishChess

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

1

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.

2

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.

3

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).

4

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).

5

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

Volley.sh

Volley

A good sequence diagram can solve almost any communication problem in engineering. Volley lets your agent write them as plain text, with the real request and response payloads on every arrow. It checks its own syntax wi

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context

22.0K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K
Advertise