Haksnbot Tools

haksnbot工具

MCP（模型上下文协议）服务器，使克劳德能够玩《我的世界》。建立在 Mineflayer，此工具允许Claude Code（或任何兼容MCP的AI）通过40多个动作控制Minecraft机器人。

特性

• 完全机器人控制 -移动、战斗、建造、制作、库存管理
• Microsoft身份验证 -适用于在线模式服务器
• 路径寻找 -使用mineflayer探路者进行自动导航
• 自动重新连接 -以指数回退方式处理断开连接
• 视觉 -机器人看到的3D渲染截图
• 村民交易 -浏览和执行交易
• 店铺整合 -适用于玩家经济的QuickShop Hikari插件

安装

git clone https://github.com/haksndot/haksnbot-tools.git
cd haksnbot-tools
npm install

使用Claude代码

添加到您的Claude Code MCP设置中(~/.claude/settings.json):

{
  "mcpServers": {
    "minecraft": {
      "command": "node",
      "args": ["/path/to/haksnbot-tools/src/index.js"]
    }
  }
}

然后在克劳德代码中：

> Connect to my Minecraft server at mc.example.com as "ClaudeBot"
> What's around me?
> Find some oak trees and chop wood
> Craft a crafting table and wooden pickaxe

可用工具（40+）

连接

状态与观察

运动

沟通

库存

容器

制作

战斗与互动

睡眠

建筑

村民交易

支架和车辆

经济（QuickShop Hikari）

视觉

认证

离线模式服务器

connect to localhost as "MyBot"

在线模式服务器（Microsoft身份验证）

connect to mc.example.com as "myemail@outlook.com" with microsoft auth

首次连接时，请在microsoft.com/link上输入设备代码。令牌被缓存以备将来使用。

# Manage auth tokens
node auth.js status myemail@outlook.com
node auth.js login myemail@outlook.com
node auth.js logout myemail@outlook.com

自动重新连接

指数回退自动重新连接：

• 初始延迟：2秒
• 最大延迟：~5分钟
• 最大尝试次数：10

使用 disconnect 完全停止机器人。

插件集成

悲伤预防（索赔保护）

机器人在执行操作时会自动检测索赔保护。在装有GriefPrevention的服务器上，机器人：

• 检查索赔所有权 在修改块或容器之前
• 尊重信任级别 （使用 /trustlist 检查权限）
• 报告明确否认 所以你知道为什么行动失败了

具有悲伤预防意识的工具：

没有悲伤预防： 所有工具工作正常。机器人根本不会检测到基于索赔的拒绝（像产卵保护这样的香草保护仍然适用）。

QuickShop Hikari（玩家经济）

对于带有QuickShop Hikari的服务器，机器人可以查询玩家商店并与之交互。这些功能需要 MC_SERVER_ROOT 指向Minecraft服务器目录的环境变量。

配置：

{
  "mcpServers": {
    "minecraft": {
      "command": "node",
      "args": ["/path/to/haksnbot-tools/src/index.js"],
      "env": {
        "MC_SERVER_ROOT": "/path/to/minecraft-server"
      }
    }
  }
}

车间工具：

没有QuickShop或MC_SERVER_ROOT： 这三个工具返回一条有用的错误消息：“QuickShop功能需要MC_SERVER_ROOT环境变量”。所有其他工具工作正常。

优雅降级总结

需求

• Node.js 18+
• 对于 take_screenshot：OpenGL支持（Linux上的Mesa）

依赖项

• 扫雷器 -Minecraft机器人框架
• 扫雷舰探路者号 -寻路
• 棱镜观察器 -3D渲染
• @模型上下文协议/sdk -MCP服务器SDK

相关项目

• haksnbot头脑 -使用Claude Agent SDK的自主Minecraft机器人
• haksnbot管理员 -服务器管理MCP工具

许可证

麻省理工学院