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 分

    请在仓库或注册中心条目中声明许可证。