mc-mcp-server

mc-mcp-server

  claude opus5.5 build the castle

⛏️ Minecraft 的 Model Context Protocol 服务。

安装

• maven

用法

该机器人会以离线玩家身份加入 Minecraft Java 版 1.21.7 服务器， 因此服务器需要设置 online-mode=false。如果你希望机器人执行命令，请给予它管理员权限（/op LLMBot）。

java -cp ... vavi.games.minecraft.mcp.MinecraftBotMCP [-host localhost] [-port 25565] [-username LLMBot]

工具

名称	描述
get-position	位置、游戏模式和生命值
move-to-position	使用寻路前往某个位置（行走、向上跨步、向下跳落）
look-at	将头部转向某个位置
jump	跳跃
move-in-direction	按指定时长向前／后／左／右行走
list-inventory, find-item	背包内容
equip-item	将物品移至主手、副手或盔甲栏
place-block	放置手持方块（如有需要，会走到可触及范围内）
dig-block	挖掘方块，生存模式下耗时与原版一致
get-block-info, find-block	读取机器人已加载区块的副本
find-entity	按类型或玩家名称查找最近的实体
send-chat	发送聊天消息，或发送以 / 开头的命令；返回服务器的响应消息
build-blocks	一次调用放置一组方块：装备物品，按顺序放置以确保每个方块都有支撑，走到可触及范围内，为高处搭建临时柱子；可恢复执行
fill-region	以相同方式填充一个立方体区域（实心、空心或仅填充墙壁）
clear-region	从顶部挖掘一个立方体区域（可选仅挖掘匹配的方块，例如原木），并使用背包中的最佳工具
scan-area	获取区域的高度图（可选忽略树木），用于规划

机器人会通过挖掘树叶来穿过树叶，并会选择最适合挖掘的工具（斧、镐、锹、锄）。

游戏数据

src/main/resources/vavi/games/minecraft/mcp/{blocks.tsv,items.txt} 根据原版服务器的数据报告 （java -DbundlerMainClass=net.minecraft.data.Main -jar server.jar --reports） 和 minecraft-data 的方块碰撞形状生成。 mcprotocollib 的协议版本变更时，请重新生成这些文件。

参考资料

• https://github.com/GeyserMC/MCProtocolLib
• https://github.com/modelcontextprotocol/java-sdk
• https://github.com/yuniko-software/minecraft-mcp-server

待办事项