{
  "markdown": "# BindAlias MCP\n\nMCP bridge for the [BindAlias](https://github.com/Prohect/BindAlias) Minecraft mod. Lets AI agents control Minecraft: query game state, take screenshots, execute aliases, manage recipes, read/write notes, and edit the per-save agent config.\n\n## Prerequisites\n\n- [Minecraft](https://www.minecraft.net) with the [BindAlias](https://github.com/Prohect/BindAlias) mod loaded\n- The mod's HTTP API enabled (listens on `127.0.0.1:25575` by default, with automatic port fallback)\n\n## Install in Zed\n\nAdd to your `settings.json`:\n\n```json\n{\n  \"context_servers\": {\n    \"bind-alias\": {\n      \"command\": {\n        \"path\": \"npx\",\n        \"args\": [\"bind-alias-mcp\"]\n      }\n    }\n  }\n}\n```\n\nOr with a local checkout:\n\n```json\n{\n  \"context_servers\": {\n    \"bind-alias\": {\n      \"command\": {\n        \"path\": \"node\",\n        \"args\": [\"path/to/BindAlias-MCP/mcp_server.js\"]\n      }\n    }\n  }\n}\n```\n\nUse `--port N` to match a non-default mod port:\n\n```json\n\"args\": [\"path/to/BindAlias-MCP/mcp_server.js\", \"--port\", \"25576\"]\n```\n\nZed spawns MCP servers at startup — reload Zed (`zed-reload`) after editing to pick up the new server.\n\n## Install via CLI\n\n```bash\nnpx bind-alias-mcp\n# or globally\nnpm install -g bind-alias-mcp\n```\n\nThe server speaks MCP on stdio. Point any MCP client at it.\n\n## Tools\n\n| Tool            | What it does                                                                                                     |\n| --------------- | ---------------------------------------------------------------------------------------------------------------- |\n| `getFullState`  | Full game state snapshot — screen, world, dimension, player pos/rot, health, hotbar, inventory, effects, nearby players, plus drained chat/mod/sound/recipe messages |\n| `getScreenshot` | Take a screenshot, return as base64 PNG with the standard state envelope                                         |\n| `runAlias`      | Execute a chain of aliases. Optional `nap` (client ticks) defers the response while the game keeps running.      |\n| `defineAlias`   | Define a new alias at runtime (requires being in a world).                                                       |\n| `readCFG`       | Read the per-save agent config (`saves/<save>/bind-alias/agent.cfg`). Requires being in a singleplayer world.   |\n| `writeCFG`      | Overwrite the per-save agent config and reload. Requires being in a singleplayer world.                         |\n| `readNotes`     | Read a file from the per-save agent directory (`saves/<save>/bind-alias/`). Plain filenames only, no paths.     |\n| `writeNotes`    | Write a file to the per-save agent directory. Plain filenames only, no paths.                                   |\n| `listRecipes`   | List unlocked recipes (diff or by query). Only works with a recipe-book screen open (inventory, crafting table, furnace, …). |\n\nThe tool descriptions only cover the wire protocol — see the [mod docs](https://github.com/Prohect/BindAlias) and the [system prompt patch](#agent-system-prompt-patch) for the full alias reference.\n\n## Agent system prompt patch\n\nThe tool descriptions this server advertises only cover the wire protocol — the fixed facts the tools themselves must know. The gameplay knowledge (the full alias catalog, screens, variables, per-world cfg semantics) changes with the mod and your world, so it lives separately in a flexible patch:\n\n- [`PATCH TO YOUR PROJECT RULE.md`](PATCH%20TO%20YOUR%20PROJECT%20RULE.md) — paste this into your agent's system prompt / project rules (e.g. Zed's `AGENTS.md`) to teach it how to drive the game.\n\n## Related\n\n- [BindAlias mod](https://github.com/Prohect/BindAlias) — the Minecraft mod this server bridges to\n- [MCP Registry](https://registry.modelcontextprotocol.io) — registered as `io.github.Prohect/bind-alias-mcp`\n",
  "bytes": 3790,
  "sha": "05672c0359a9d1334148162c78f6b8a8fff75d151abbe9f66bcc7ca1747a6945",
  "repo_slug": "prohect/bindalias-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_prohect_bind_alias_mcp_81e583b5/readme"
}