sonirico/mcp-stockfish

Deployment & DevOps

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

16 stars 8 forks 품질 58 트렌드 21MIT

Repository Install

🐟 MCP server connecting AI systems to Stockfish chess engine

개요

A Model Context Protocol server that lets your AI talk to Stockfish. Because apparently we needed to make chess engines even more accessible to our silicon overlords. 🧠⚡🖥️ Your LLM thinks, Stockfish calculates, you pretend you understand the resulting 15-move tactical sequence. This creates a bridge between AI systems and the Stockfish chess engine via the MCP protocol. It handles multiple concurrent sessions because your AI probably wants to analyze seventeen positions simultaneously while you're still figuring out why your knight is hanging. Built on mark3labs/mcp-go. Because reinventing wheels is for people with too much time.

README

원문 README의 일부입니다. 원문 보기.

mcp-stockfish 🐟

A Model Context Protocol server that lets your AI talk to Stockfish. Because apparently we needed to make chess engines even more accessible to our silicon overlords.

🧠⚡🖥️ Your LLM thinks, Stockfish calculates, you pretend you understand the resulting 15-move tactical sequence.

What is this?

This creates a bridge between AI systems and the Stockfish chess engine via the MCP protocol. It handles multiple concurrent sessions because your AI probably wants to analyze seventeen positions simultaneously while you’re still figuring out why your knight is hanging.

Built on mark3labs/mcp-go. Because reinventing wheels is for people with too much time.

Features

🔄 Concurrent Sessions: Run multiple Stockfish instances without your CPU crying
⚡ Full UCI Support: All the commands you need, none of the ones you don’t
🎯 Actually Works: Unlike your last side project, this one has proper error handling
📊 JSON Everything: Because apparently we can’t just use plain text anymore
🐳 Docker Ready: Containerized for when you inevitably break your local setup

Supported UCI Commands ♟️

Command	Description
`uci`	Initializes the engine in UCI mode
`isready`	Checks if the engine is ready. Returns `readyok`
`position startpos`	Sets up the board to the starting position
`position fen [FEN]`	Sets up a position using FEN notation
`go`	Starts the engine to compute the best move
`go depth [n]`	Searches `n` plies deep. Example: `go depth 10`
`go movetime [ms]`	Thinks for a fixed amount of time in milliseconds. Example: `go movetime 1000`
`stop`	Stops current search
`quit`	Closes the session

Quick Start

Installation

git clone https://github.com/sonirico/mcp-stockfish
cd mcp-stockfish
make install

Usage

# Default mode (stdio, because we're old school)
mcp-stockfish

# With custom Stockfish path (for the special snowflakes)
MCP_STOCKFISH_PATH=/your/special/stockfish mcp-stockfish

# HTTP mode (for the web-scale crowd)
MCP_STOCKFISH_SERVER_MODE=http mcp-stockfish

Configuration ⚙️

Environment Variables

Server Configuration

MCP_STOCKFISH_SERVER_MODE: “stdio” or “http” (default: “stdio”)

GitHub에서 전체 README 보기

설치

This server does not publish a one-line install command.

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "chess": {
      "command": "mcp-stockfish",
      "env": {
        "MCP_STOCKFISH_LOG_LEVEL": "info"
      }
    }
  }
}