Skip to main content

A Stockfish MCP server

Project description

Stockfish MCP Server

A Stockfish server for the Model Context Protocol. This package allows a Large Language Model to play chess against the Stockfish engine.

Installation

Install the package from PyPI:

pip install stockfish-mcp

Usage

Run the server from the command line:

stockfish-mcp

You can also provide a path to a custom Stockfish executable:

stockfish-mcp --stockfish-path /path/to/your/stockfish

## Example

An example of a game played against the Stockfish engine can be found in [`exampleGame.md`](./exampleGame.md).

## Available Tools

- `get_board_state()`: Get the current board state.
- `make_move(move_uci: str)`: Make a move (e.g., "e2e4").
- `is_game_over()`: Check if the game has ended.
- `get_game_result()`: Get the result if the game is over.
- `reset_game(skill_level: int = 10)`: Start a new game.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

stockfish_mcp-0.2.1.tar.gz (4.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

stockfish_mcp-0.2.1-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

Details for the file stockfish_mcp-0.2.1.tar.gz.

File metadata

  • Download URL: stockfish_mcp-0.2.1.tar.gz
  • Upload date:
  • Size: 4.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for stockfish_mcp-0.2.1.tar.gz
Algorithm Hash digest
SHA256 54a721f0c966b9f9619838c108d19bf167a98772cdaa624c85a7163b18238ee9
MD5 dcabf7654613f00448414c224a990e75
BLAKE2b-256 89f48054b4269741d047cb215cb3cb79149516f6b4cc40be941fbb19006a3c9d

See more details on using hashes here.

Provenance

The following attestation bundles were made for stockfish_mcp-0.2.1.tar.gz:

Publisher: publish-mcp.yml on stepbot/StockfishMcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file stockfish_mcp-0.2.1-py3-none-any.whl.

File metadata

  • Download URL: stockfish_mcp-0.2.1-py3-none-any.whl
  • Upload date:
  • Size: 5.0 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for stockfish_mcp-0.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 6817a3f7f93e4ea849cc1e0e98ba6823090cd9676ee366925bff1ea1d2e85197
MD5 0a5d5028d759975c127aa3c6a8cb2061
BLAKE2b-256 19619bd15ed762ac9a872c608fefab73fd4f1dc086cbf21080251014d2ffd9ef

See more details on using hashes here.

Provenance

The following attestation bundles were made for stockfish_mcp-0.2.1-py3-none-any.whl:

Publisher: publish-mcp.yml on stepbot/StockfishMcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page