mcplist
CC

ChessPal Chess Engine (stockfish)

Created 5 months ago

A Stockfish-powered chess engine exposed as an MCP server using FastMCP.

Visit Homepage
development documentation public chess MCP

What is ChessPal Chess Engine (stockfish)?

A Stockfish-powered chess engine exposed as an MCP server. Calculates best moves and supports both HTTP/SSE and stdio transports.

Documentation

ChessPal Chess Engine

Features

  • Robust Stockfish engine integration with proper process management
  • Exposes engine functionality via the Model Context Protocol (MCP) using FastMCP.
  • Supports both SSE and stdio MCP transports for client interaction.
  • UCI protocol implementation for chess move generation
  • Comprehensive test suite with TDD approach
  • Error handling and recovery mechanisms
  • Support for FEN positions and move history
  • Flexible engine binary configuration

Prerequisites

  • Python 3.10 or higher
  • Poetry for dependency management
  • Stockfish chess engine binary (version 17.1 recommended)

Installation

Install the published package from PyPI using pip:

pip install chesspal-mcp-engine

Usage# Starting the Server

The server uses FastMCP with support for both Server-Sent Events (SSE) and stdio transports. You can start it using:\n\n#### SSE Mode (Default)

poetry run python -m chesspal_mcp_engine.main

API Endpoints

The module exposes the following endpoints through FastMCP:

  • get_best_move_tool
  • validate_move_tool
  • get_legal_moves_tool
  • get_game_status_tool

License

GNU General Public License v3.0 - see LICENSE file for details.

Server Config 

{
  "mcpServers": {
    "chesspal-chess-engine-(stockfish)-server": {
      "command": "npx",
      "args": [
        "chesspal-chess-engine-(stockfish)"
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Jul 02, 2025
Updated At: Aug 07, 2025
Author: Wilson Urdaneta
Category: community
License: GNU General Public License v3.0
Tags:
development documentation public