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]|[<<path_to>node.exe>>]",
"args": ["<<path_to>BindAliasPlus-MCP/mcp_server.js>"]
}
}
}
}
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