feat: Convert project to PyPI package

Author: stepbot

.github/workflows/publish-mcp.yml

@@ -1,36 +1,76 @@
-name: Publish to MCP Registry
+name: Publish to PyPI and MCP Registry
 
 on:
   push:
     tags:
-      - 'v*' # Triggers on version tags like v1.0.0
+      - 'v*'
 
 jobs:
+  build_wheels:
+    name: Build wheels on ${{ matrix.os }}
+    runs-on: ${{ matrix.os }}
+    strategy:
+      matrix:
+        os: [ubuntu-latest, windows-latest, macos-latest]
+        include:
+          - os: ubuntu-latest
+            cibw_build: "*-manylinux_x86_64"
+          - os: windows-latest
+            cibw_build: "*-win_amd64"
+          - os: macos-latest
+            cibw_build: "*-macosx_x86_64 *-macosx_arm64"
+
+    steps:
+      - uses: actions/checkout@v3
+
+      - name: Set up Python
+        uses: actions/setup-python@v3
+        with:
+          python-version: '3.x'
+
+      - name: Download Stockfish
+        run: |
+          mkdir -p stockfish_mcp/bin
+          if [ "$RUNNER_OS" == "Linux" ]; then
+            curl -L "https://github.com/official-stockfish/Stockfish/releases/latest/download/stockfish-ubuntu-x86-64-avx2.tar" | tar -x -C stockfish_mcp/bin --strip-components=1
+          elif [ "$RUNNER_OS" == "Windows" ]; then
+            curl -L "https://github.com/official-stockfish/Stockfish/releases/latest/download/stockfish-windows-x86-64-avx2.zip" -o stockfish.zip
+            unzip stockfish.zip -d stockfish_mcp/bin
+          elif [ "$RUNNER_OS" == "macOS" ]; then
+            curl -L "https://github.com/official-stockfish/Stockfish/releases/latest/download/stockfish-macos-x86-64.tar" | tar -x -C stockfish_mcp/bin --strip-components=1
+          fi
+        shell: bash
+
+      - name: Build wheels
+        uses: pypa/cibuildwheel@v2.16.2
+        env:
+          CIBW_BUILD: ${{ matrix.cibw_build }}
+
+      - name: Store wheel
+        uses: actions/upload-artifact@v4
+        with:
+          path: ./wheelhouse/*.whl
+
   publish:
+    name: Publish to PyPI and MCP Registry
+    needs: build_wheels
     runs-on: ubuntu-latest
     permissions:
-      contents: read
-      packages: write
-      id-token: write # Required for OIDC authentication
+      id-token: write
 
     steps:
-      - name: Checkout repository
-        uses: actions/checkout@v3
+      - uses: actions/checkout@v3
 
-      - name: Log in to the GitHub Container Registry
-        uses: docker/login-action@v2
+      - name: Download all wheels
+        uses: actions/download-artifact@v4
         with:
-          registry: ghcr.io
-          username: ${{ github.actor }}
-          password: ${{ secrets.GITHUB_TOKEN }}
+          path: dist/
 
-      - name: Build and push Docker image
-        uses: docker/build-push-action@v4
+      - name: Publish to PyPI
+        uses: pypa/gh-action-pypi-publish@release/v1
         with:
-          context: .
-          push: true
-          tags: ghcr.io/stepbot/stockfish-mcp:${{ github.ref_name }}
-          labels: io.modelcontextprotocol.server.name=io.github.stepbot/stockfish-mcp
+          user: __token__
+          password: ${{ secrets.PYPI_API_TOKEN }}
 
       - name: Install MCP Publisher
         run: |

Dockerfile

@@ -1,58 +1,29 @@
 # Stockfish MCP Server
 
-This project implements a simple MCP (Model Context Protocol) server that allows an LLM to play chess against the Stockfish engine.
+<!-- mcp-name: io.github.stepbot/stockfish-mcp -->
 
-## Features
+A Stockfish server for the Model Context Protocol. This package allows a Large Language Model to play chess against the Stockfish engine.
 
-- Play a game of chess against Stockfish.
-- Get the board state in FEN and Markdown format.
-- Make moves using UCI notation.
-- Reset the game with a specific skill level for the engine.
+## Installation
 
-## Installation from Registry
+Install the package from PyPI:
 
-You can install and run this server directly from the MCP registry using an MCP-compatible client. Update your `mcp_settings.json` to include the following server configuration:
-
-```json
-{
-  "mcpServers": {
-    "chess": {
-      "package": "io.github.stepbot/stockfish-mcp@v0.1.3"
-    }
-  }
-}
+```bash
+pip install stockfish-mcp
 ```
 
-Your client will automatically download and manage the server package.
-
-## Local Development Setup
-
-1.  **Clone the repository:**
-    ```bash
-    git clone <repository-url>
-    cd StockfishMcp
-    ```
-
-2.  **Install `uv`:**
-    If you don't have `uv` installed, you can install it with:
-    ```powershell
-    powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
-    ```
-    After installation, you may need to add the installation directory (usually `C:\Users\<YourUser>\.local\bin` on Windows) to your system's PATH and restart your terminal.
-
-3.  **Download Stockfish:**
-    You need to download the Stockfish engine separately. You can find it on the [official Stockfish website](https://stockfishchess.org/download/).
+## Usage
 
-4.  **Configure the MCP Server:**
-    To use this server, you must add an entry for it in your global `mcp_settings.json` file. This file tells your MCP client how to launch the server.
+Run the server from the command line:
 
-    An example configuration is provided in `mcp_settings.example.json`. You should copy this configuration into your `mcp_settings.json` file and update the following paths:
-    - The path to the `mcp_server.py` script in this project.
-    - The path to your downloaded Stockfish executable for the `--stockfish-path` argument.
+```bash
+stockfish-mcp
+```
 
-## Usage
+You can also provide a path to a custom Stockfish executable:
 
-The server is managed by your MCP client and will be launched using `uv`. `uv` will automatically handle the virtual environment and dependencies from `requirements.txt`. The MCP client will pass the `--stockfish-path` argument to the server on startup.
+```bash
+stockfish-mcp --stockfish-path /path/to/your/stockfish
 
 ## Example
 

README.md

@@ -0,0 +1,26 @@
+[build-system]
+requires = ["setuptools>=61.0"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "stockfish-mcp"
+version = "0.2.0"
+authors = [
+  { name="Stephan Botes", email="stephanbotes@gmail.com" },
+]
+description = "A Stockfish MCP server"
+readme = "README.md"
+requires-python = ">=3.8"
+classifiers = [
+    "Programming Language :: Python :: 3",
+    "License :: OSI Approved :: MIT License",
+    "Operating System :: OS Independent",
+]
+dependencies = [
+    "fastmcp",
+    "chess",
+    "stockfish",
+]
+
+[project.scripts]
+stockfish-mcp = "stockfish_mcp.__main__:main"

pyproject.toml

@@ -2,12 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
   "name": "io.github.stepbot/stockfish-mcp",
   "title": "Stockfish MCP",
-  "description": "An MCP server for playing chess against Stockfish.",
+  "description": "A Stockfish MCP server to allow an LLM to play chess against Stockfish",
   "version": "__VERSION__",
   "packages": [
     {
-      "registryType": "oci",
-      "identifier": "ghcr.io/stepbot/stockfish-mcp:__VERSION__",
+      "registryType": "pypi",
+      "identifier": "stockfish-mcp",
+      "version": "__VERSION__",
       "transport": {
         "type": "stdio"
       }

requirements.txt

@@ -0,0 +1,9 @@
+from setuptools import setup, find_packages
+
+setup(
+    packages=["stockfish_mcp", "stockfish_mcp.bin"],
+    include_package_data=True,
+    package_data={
+        "stockfish_mcp.bin": ["*"],
+    },
+)

server.json

@@ -0,0 +1,42 @@
+import argparse
+import os
+import platform
+import sys
+from .mcp_server import mcp, game
+from .chess_logic import ChessGame
+
+def get_stockfish_path():
+    """
+    Determines the path to the correct Stockfish binary based on the OS and architecture.
+    """
+    system = platform.system()
+    machine = platform.machine()
+    
+    base_path = os.path.join(os.path.dirname(__file__), 'bin')
+
+    if system == "Linux":
+        return os.path.join(base_path, "stockfish-ubuntu-x86-64-avx2")
+    elif system == "Windows":
+        return os.path.join(base_path, "stockfish-windows-x86-64-avx2.exe")
+    elif system == "Darwin": # macOS
+        if machine == "arm64":
+            return os.path.join(base_path, "stockfish-macos-arm64")
+        else:
+            return os.path.join(base_path, "stockfish-macos-x86-64")
+    
+    raise OSError("Unsupported operating system")
+
+
+def main():
+    parser = argparse.ArgumentParser(description="Run the Chess MCP server.")
+    parser.add_argument("--stockfish-path", help="Path to a custom Stockfish executable.")
+    args = parser.parse_args()
+
+    stockfish_path = args.stockfish_path if args.stockfish_path else get_stockfish_path()
+
+    global game
+    game = ChessGame(stockfish_path=stockfish_path, skill_level=10)
+    mcp.run()
+
+if __name__ == "__main__":
+    main()