chesspal-mcp-engine

chesspal-mcp-engine

0
entertainment_and_media

ChessPal Chess Engine leverages the powerful Stockfish chess engine and exposes it as an MCP server using FastMCP to provide chess move calculations. It supports both SSE and stdio transports, making it versatile for integration in various client applications.

ChessPal Chess Engine

Overview

  • A Stockfish-powered chess engine exposed as an MCP server using FastMCP.
  • Calculated best moves accessible over SSE or stdio transports using an MCP client library.
  • Part of the ChessPal project.

Features

  • Robust Stockfish integration with process management.
  • Supports SSE and stdio MCP transports.
  • Includes UCI protocol for chess moves.
  • Comprehensive test suite with TDD approach.
  • Error handling and recovery mechanisms.
  • FEN positions and move history support.
  • Flexible engine binary configuration.

Prerequisites

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

Installation

  • Install via PyPI.
  • Development installation through cloning the repository and using Poetry.

Usage

  • Start server with SSE or stdio transport.
  • API endpoints for getting best moves, validating moves, and querying game status.

Development

  • Project includes dependencies management with Poetry, testing with pytest, and code quality tools (black, isort, flake8).

License

  • GNU General Public License v3.0.