Skip to content
Sheriff

Installation

Sheriff can be installed via Docker, JAR download, or by building from source.

Docker

Section titled “Docker”
Terminal window
docker pull ghcr.io/ryansmith4/sheriff-mcp:latest

No Java installation required. See Agent Setup for MCP client configuration with Docker.

MCP Registry

Section titled “MCP Registry”

Clients that support the MCP Registry can install Sheriff directly by name:

io.github.ryansmith4/sheriff-mcp

JAR Download

Section titled “JAR Download”

  1. Download the latest sheriff-mcp-1.0.2-all.jar from GitHub Releases

  2. Place it in a location of your choice (e.g., ~/tools/ or C:\tools\)

  3. Run with Java:

    Terminal window
    java -jar sheriff-mcp-1.0.2-all.jar start

Build from Source

Section titled “Build from Source”
Terminal window
git clone https://github.com/ryansmith4/sheriff-mcp.git
cd sheriff-mcp
./gradlew fatJar
# JAR at build/libs/sheriff-mcp-*-all.jar

Verify Installation

Section titled “Verify Installation”
Terminal window
java -jar sheriff-mcp-1.0.2-all.jar --version
# Sheriff 1.0.2

Requirements

Section titled “Requirements”
  • Java 21+ is required (for JAR and build from source — not needed for Docker)
  • Verify with: java -version

Next Steps

Section titled “Next Steps”

Once installed, configure your MCP client to use Sheriff:

  • Agent Setup - Configure Claude Code, Cursor, ChatGPT Desktop, or other MCP clients