BindAliasPlus MCP

MCP bridge for the BindAliasPlus Minecraft mod. Lets AI agents control Minecraft: query game state, take screenshots, execute aliases, and edit the mod config.

Prerequisites

• Minecraft with the BindAliasPlus mod loaded
• The mod's HTTP API enabled (listens on 127.0.0.1:25575)

Install in Zed

Add to your settings.json:

{
  "context_servers": {
    "bind-alias-plus": {
      "command": {
        "path": "npx",
        "args": ["-y", "bind-alias-plus-mcp"]
      }
    }
  }
}

Sandbox permission — the server connects to the mod on 127.0.0.1. Add it to your network allowlist if you use Zed's agent sandbox:

{
  "agent": {
    "sandbox_permissions": {
      "network_hosts": ["127.0.0.1"]
    }
  }
}

Install via CLI

npx bind-alias-plus-mcp
# or globally
npm install -g bind-alias-plus-mcp

The server speaks MCP on stdio. Point any MCP client at it.

Tools

Tool	What it does
getState	Game state snapshot: screen, world, dimension, player pos/rot, health, held item
getScreenshot	Trigger F2 screenshot, return as base64 PNG
runAlias	Execute a BindAliasPlus alias (34+ argless, 18 with args)
defineAlias	Define a new alias (requires being in a world)
readCFG	Read bind-alias-plus.cfg contents
writeCFG	Overwrite bind-alias-plus.cfg and reload

See runAlias description for full alias reference, or the mod docs.

Related

• BindAliasPlus mod — the Minecraft mod this server bridges to
• MCP Registry — registered as io.github.Prohect/bind-alias-plus-mcp