mcpField
B
bind-alias-mcp

bind-alias-mcp

本地服务
github.com/Prohect游戏娱乐012 周前更新
代码仓库

关于 bind-alias-mcp

bind-alias-mcp 将 MCP 客户端连接到运行 BindAlias 模组的 Minecraft，让 Agent 查看游戏状态和截图、执行别名、管理配方与笔记，并编辑每个存档的配置。

主要功能

  1. 01读取完整游戏状态
  2. 02获取 PNG 截图
  3. 03运行和定义别名
  4. 04读取和写入笔记
  5. 05读取和编辑存档配置
  6. 06列出已解锁配方

适用场景

  1. 01查看当前游戏与玩家状态
  2. 02为 Agent 获取游戏截图
  3. 03在游戏过程中执行别名链
  4. 04更新特定存档的笔记或配置

MCP 相关

MCP 服务通过 stdio 通信，并提供调用 BindAlias 模组 HTTP API 的工具。需要运行已加载该模组且启用 HTTP API 的 Minecraft。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "prohect-bind-alias": {
      "command": "npx",
      "args": [
        "-y",
        "bind-alias-mcp"
      ]
    }
  }
}
启动命令npx -y bind-alias-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npmbind-alias-mcp2.2.0

工具

8

收录的工具列表 · 更新于 2 周前

参数类型必填说明
defstring是别名链定义。空格（' '）用于分隔别名（含参数），斜杠（'/'）用于分隔 alias_name 与参数或参数之间，双引号（'"'）用于括起多词参数，防止其中的空格被解析为别名（含参数）分隔符：例如 `say/"hello world"`。分号用于分隔别名（名为 `alias`）的额外部分：例如 `alias/turnDown;setPitch/90`、`alias/turnRight;yaw/90`
napinteger否可选（1-1200）。将工具调用的响应延迟 N 个 client_tick：操作会立即运行，但只有经过 N 个 client_tick 后才捕获封装。游戏在此期间会持续运行——调用返回前，你无法对任何内容作出反应或轮询状态。N >= 10 时，休眠期间会以约 20 tps 快进单人世界。
verboseboolean否可选（默认 false）。为 true 时，封装中的状态为完整快照，而非差异。

详细介绍

BindAlias MCP

用于 BindAlias Minecraft 模组的 MCP 桥接服务。让 AI Agent 能够控制 Minecraft：查询游戏状态、截取屏幕、执行别名、管理配方、读取/写入笔记，以及编辑每个存档的 Agent 配置。

前提条件

  • 已加载 BindAlias 模组的 Minecraft
  • 已启用该模组的 HTTP API（默认监听 127.0.0.1:25575，并支持自动切换端口）

在 Zed 中安装

添加到你的 settings.json 中：

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

或使用本地检出版本：

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

使用 --port N 匹配非默认模组端口：

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

Zed 会在启动时启动 MCP 服务——编辑后重新加载 Zed（zed-reload）以加载新的服务。

通过命令行安装

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

该服务通过 stdio 使用 MCP 通信。将任意 MCP 客户端指向该服务。

工具

工具功能
getFullState完整的游戏状态快照——屏幕、世界、维度、玩家位置/朝向、生命值、快捷栏、物品栏、效果、附近玩家，以及已排空的聊天/模组/声音/配方消息
getScreenshot截取屏幕，并以 base64 PNG 格式返回，同时附带标准状态封装
runAlias执行一串别名。可选的 nap（客户端刻）会延迟响应，同时游戏继续运行。
defineAlias在运行时定义新别名（需要处于世界中）。
readCFG读取每个存档的 Agent 配置（saves/<save>/bind-alias/agent.cfg）。需要处于单人游戏世界中。
writeCFG覆盖每个存档的 Agent 配置并重新加载。需要处于单人游戏世界中。
readNotes从每个存档的 Agent 目录（saves/<save>/bind-alias/）读取文件。仅限纯文件名，不允许使用路径。
writeNotes向每个存档的 Agent 目录写入文件。仅限纯文件名，不允许使用路径。
listRecipes列出已解锁的配方（差异或按查询列出）。仅在配方书界面打开时有效（物品栏、工作台、熔炉等）。

工具说明只涵盖线路协议——完整的别名参考请参阅模组文档和系统提示词补丁。

Agent 系统提示词补丁

此服务公布的工具说明只涵盖线路协议——也就是工具本身必须了解的固定信息。游戏玩法知识（完整的别名目录、界面、变量、每个世界的 cfg 语义）会随模组和你的世界而变化，因此单独放在一个灵活的补丁中：

  • PATCH TO YOUR PROJECT RULE.md — 将其粘贴到 Agent 的系统提示词/项目规则中（例如 Zed 的 AGENTS.md），教会它如何操作游戏。

相关项目

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。