Stockfish

Stockfish

MCP server connecting AI systems to Stockfish chess engine

4
Stars
5
Forks
1
Releases

Overview

mcp-stockfish is a Model Context Protocol server that bridges AI systems to the Stockfish chess engine. It exposes Stockfish to LLMs and other AI agents through MCP, enabling multiple concurrent sessions so several positions can be analyzed in parallel. Built on mark3labs/mcp-go, it leverages the MCP protocol to manage sessions, UCI state, and command execution, while providing robust error handling and a JSON-centric interface. The server supports the full UCI command set (uci, isready, position, go, stop, quit, etc.), and can run in stdio mode or HTTP mode for web-scale deployments. It also ships with Docker readiness for containerized deployment and is designed to prevent resource exhaustion with session timeouts and concurrency controls. The Quick Start demonstrates installation, usage, and a sample Claude Desktop integration. It emphasizes reliable operation, JSON-formatted responses, and straightforward integration with existing AI workflows.

Details

Owner
sonirico
Language
Go
License
MIT License
Updated
2025-12-07

Features

Concurrent Sessions

Run multiple Stockfish instances in parallel, enabling simultaneous analyses across positions.

Full UCI Support

Supports all essential UCI commands needed to operate the engine inside the MCP server.

Actually Works

Robust error handling to avoid silent failures and misleading results.

JSON Everything

All interactions and responses are JSON-formatted for consistency.

Docker Ready

Containerized deployment with a setup ready for Docker environments.

HTTP Mode

Optional HTTP server mode for web-scale deployments.

Audience

AI DevelopersConnect AI agents/LLMs to Stockfish via MCP and manage multiple concurrent sessions for chess analysis.
Web-scale DevelopersUse HTTP mode to expose or integrate Stockfish-powered analysis in web-scale applications.

Tags

MCPStockfishChess EngineUCIConcurrent SessionsJSONHTTPDockerGo