minecraft-mcp-rs

MCP server that controls a Minecraft bot (azalea) — prebuilt native binaries.

Usage

npx -y [email protected] --headless --stdio
bunx [email protected] --headless --stdio

This package supports Minecraft Java Edition 1.21.11 only. Other Minecraft versions are not supported — see the root README for the version compatibility table.

or install globally:

npm install -g minecraft-mcp-rs
minecraft-mcp-rs --headless --stdio

For Claude Desktop / Cursor, add to your MCP client config:

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": ["-y", "[email protected]", "--headless", "--stdio"]
    }
  }
}

Using bun? Replace "command": "npx" with "command": "bunx" and drop the -y flag (bunx installs on demand without prompting).

See the root README for the full documentation (environment variables, MCP tools, CLI flags).

Platform packages

The main package is a thin launcher; the native binary ships in one of five platform packages selected automatically at install time:

| Package | Platform | | --- | --- | | minecraft-mcp-rs-windows-x64 | Windows x64 | | minecraft-mcp-rs-windows-arm64 | Windows arm64 | | minecraft-mcp-rs-darwin-arm64 | macOS arm64 | | minecraft-mcp-rs-linux-x64 | Linux x64 | | minecraft-mcp-rs-linux-arm64 | Linux arm64 |

Installing with --omit=optional breaks the launcher; reinstall the matching platform package explicitly to fix it.