Bind Alias Plus Mcp

io.github.Prohect由 GitHub 帳號 Prohect 發布v1.0.2更新於 Nov 10, 2026

MCP bridge for BindAliasPlus Minecraft mod: game state, screenshots, aliases, and config editing.

已驗證STDIO僅桌面檔案與儲存開發者工具

概覽

AI 產生的概覽

將 AI 助理連接到 BindAlias Minecraft 模組，讓它能查看遊戲狀態、截圖、執行別名並編輯存檔設定。

可以做什麼
這個本機 MCP 伺服器連接 BindAlias Minecraft 模組的 HTTP API，並提供用來操作遊戲的工具。工具包括 getFullState（畫面、世界、玩家位置、生命值、物品欄、效果、附近玩家、聊天等完整快照）、getScreenshot（回傳 base64 PNG）、runAlias 與 defineAlias（執行或於執行時建立別名鏈）、readCFG 與 writeCFG（讀寫每個存檔的 agent 設定）、readNotes 與 writeNotes（讀寫存檔 agent 目錄中的檔案），以及 listRecipes（列出已解鎖配方）。
適用情境
當你希望 AI 代理在裝有 BindAlias 模組的 Minecraft 世界中觀察並操作時使用，例如自動化遊戲流程、撰寫別名鏈，或讓代理讀取並調整自己的存檔設定與筆記。
執行需求
需要已載入 BindAlias 模組的 Minecraft，並啟用該模組的 HTTP API（預設 127.0.0.1:25575，連接埠會自動退回；非預設連接埠可用 --port N 指定）。伺服器透過 stdio 在本機執行，可用 npx bind-alias-mcp 或 npm install -g bind-alias-mcp 安裝，因此需要 Node.js。僅支援桌面端；未宣告驗證或環境變數。
安裝前請注意
此伺服器會寫入資料：writeCFG 會覆寫每個存檔的 agent 設定並重新載入，writeNotes 會將檔案寫入存檔 agent 目錄，defineAlias 會於執行時建立別名。runAlias 會執行在遊戲中產生作用的別名鏈。readCFG、writeCFG 和 defineAlias 需要處於單人世界，readNotes/writeNotes 只接受純檔名。模組的 HTTP API 監聽本機位址。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Bind Alias Plus Mcp，將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only，透過 STDIO。 STDIO 服務會啟動本機處理程序，因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

BindAlias MCP

MCP bridge for the 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.

Prerequisites

  • Minecraft with the BindAlias mod loaded
  • The mod's HTTP API enabled (listens on 127.0.0.1:25575 by default, with automatic port fallback)

Install in Zed

Add to your settings.json:

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

Or with a local checkout:

json
{  "context_servers": {    "bind-alias": {      "command": {        "path": "node",        "args": ["path/to/BindAlias-MCP/mcp_server.js"]      }    }  }}

Use --port N to match a non-default mod port:

json
"args": ["path/to/BindAlias-MCP/mcp_server.js", "--port", "25576"]

Zed spawns MCP servers at startup — reload Zed (zed-reload) after editing to pick up the new server.

Install via CLI

bash
npx bind-alias-mcp# or globallynpm install -g bind-alias-mcp

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

Tools

ToolWhat it does
getFullStateFull game state snapshot — screen, world, dimension, player pos/rot, health, hotbar, inventory, effects, nearby players, plus drained chat/mod/sound/recipe messages
getScreenshotTake a screenshot, return as base64 PNG with the standard state envelope
runAliasExecute a chain of aliases. Optional nap (client ticks) defers the response while the game keeps running.
defineAliasDefine a new alias at runtime (requires being in a world).
readCFGRead the per-save agent config (saves/<save>/bind-alias/agent.cfg). Requires being in a singleplayer world.
writeCFGOverwrite the per-save agent config and reload. Requires being in a singleplayer world.
readNotesRead a file from the per-save agent directory (saves/<save>/bind-alias/). Plain filenames only, no paths.
writeNotesWrite a file to the per-save agent directory. Plain filenames only, no paths.
listRecipesList unlocked recipes (diff or by query). Only works with a recipe-book screen open (inventory, crafting table, furnace, …).

The tool descriptions only cover the wire protocol — see the mod docs and the system prompt patch for the full alias reference.

Agent system prompt patch

The 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:

  • PATCH TO YOUR PROJECT RULE.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.

Related

來源：README.md，提交 0439549

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包，因此其工具未知。

版本歷史

1
  1. v1.0.2最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度，依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價，也不表示伺服器安全或目前可用：可連通性是帶日期的檢查結果，評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手；SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭，或保持端點能夠回應探測，以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list，或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。