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.0.tar.gz (4.0 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.0-py3-none-any.whl (5.0 kB view details)

Uploaded Python 3

File details

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

File metadata

  • Download URL: stockfish_mcp-0.2.0.tar.gz
  • Upload date:
  • Size: 4.0 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.0.tar.gz
Algorithm Hash digest
SHA256 81505a0b0e1e0a21a81adbd49a8aa9c294ae8c1a3fc611df2ee46904fb4d8dfb
MD5 16f2714542dca5318a966e9dc902e274
BLAKE2b-256 bc0540617326f3125aa57184af65a30722ea5613ea7144ff0894f6dd0e8e31c4

See more details on using hashes here.

Provenance

The following attestation bundles were made for stockfish_mcp-0.2.0.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.0-py3-none-any.whl.

File metadata

  • Download URL: stockfish_mcp-0.2.0-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.0-py3-none-any.whl
Algorithm Hash digest
SHA256 1a912c195547f40def190e33ff20229da57748bb3c06037c5296bafa8b6a24c3
MD5 497d6fde8d4e89ee400a6cabed0129ce
BLAKE2b-256 74cda992c3a4b41945d0c3b18a5994aa114b39d248f2be476c2bdaf57824e4c2

See more details on using hashes here.

Provenance

The following attestation bundles were made for stockfish_mcp-0.2.0-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