DEPLOY GUIDE

RUN YOUR
OWN SERVER

You need a Linux host with sudo, Node.js 18+, and enough headroom to also run a Java server.

01 Bare metal (recommended)

One script installs Java 21, the latest PaperMC build, Geyser + Floodgate, accepts the EULA, wires three systemd units, and runs a final health check.

sudo apt install -y git
sudo mkdir -p /opt/minecraft-bot-mcp && sudo chown "$USER":"$USER" /opt/minecraft-bot-mcp
git clone https://github.com/christopherdeck/minecraft-mcp.git /opt/minecraft-bot-mcp
cd /opt/minecraft-bot-mcp
bash scripts/deploy-java.sh
02 Docker (Linux, macOS, Windows)

Prefer containers, or on Windows/macOS? These package the MCP server as a Docker image. Default mode connects to a Java server you already run — add --full-stack to also let Docker run a bundled PaperMC + Geyser + Floodgate.

bash scripts/install-linux.sh          # Linux
.\scripts\install-windows.ps1          # Windows (PowerShell 5.1+)
03 Connect
Bedrock client your-host:19132
Java client your-host:25565
MCP agent http://your-host:3100/mcp
Dashboard http://your-host:3100/dashboard
Health probe http://your-host:3100/health
04 Key config vars
MINECRAFT_AUTH offline for Floodgate/cracked, microsoft for online-mode Java
MCP_AUTH_TOKEN optional bearer token; when set it gates every route, fail-closed
MCP_DEFAULT_BOT auto-connects on boot with capped backoff retry (default MCPTestBot)
MCP_BOT_IMPL mineflayer (default) or bedrock for the legacy v2 fallback