Minecraft MCP 服务器

⚠️ 重要兼容性警告：截至2025年3月25日，Minecraft 1.21.5刚刚发布。此机器人目前与Minecraft 1.21.5 不兼容。请使用Minecraft 1.21.4直到我们发布支持1.21.5的更新。

由大型语言模型和Mineflayer API驱动的Minecraft机器人。此机器人通过模型上下文协议（MCP）启用Claude和其他支持的模型来控制一个Minecraft角色。

先决条件

• Node.js
• 正在运行的Minecraft游戏（以下设置经过测试，使用Microsoft Game Pass中包含的Minecraft 1.21.4 Java版）
• Claude Desktop

开始使用

此机器人设计用于通过模型上下文协议（MCP）与Claude Desktop一起使用。

运行Minecraft

创建一个单人世界并将其开放到LAN（ESC -> 打开 LAN游戏）。机器人将尝试连接到端口25565和主机名localhost。这些参数可以在下一步配置在claude_desktop_config.json中。

MCP配置

确保Claude Desktop已安装。打开文件 -> 设置 -> 开发者 -> 编辑配置，它应该会打开安装目录。找到名为claude_desktop_config.json的文件并插入以下代码：

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

检查是否正确使用了--port和--host参数。确保完全重新启动Claude Desktop应用程序（应该在操作系统托盘中关闭）。

运行

确保Minecraft游戏正在运行，并且世界已开放到LAN。然后启动Claude Desktop应用程序，机器人应该会加入游戏。

Claude Desktop启动MCP服务器可能需要一些时间。服务器成功启动的标志是聊天旁边出现了一个锤子图标。

你可以通过任何活动的Claude Desktop聊天为机器人发送命令。你还可以上传建筑物的图像并让机器人建造它们 😁

别忘了提到机器人应该在Minecraft中执行某些操作，因为这是运行MCP服务器的触发器。它会询问你的权限。

使用Claude 3.7 Sonnet可能会得到一些有趣的结果。机器人代理会非常聪明 🫡

示例用法：共享Claude聊天

可用命令

连接到Minecraft服务器后，Claude可以使用以下命令：

移动

• get-position - 获取机器人当前位置
• move-to-position - 移动到特定坐标
• look-at - 使机器人看向特定坐标
• jump - 让机器人跳跃
• move-in-direction - 向特定方向移动一段持续时间

存货

• list-inventory - 列出机器人存货中的所有物品
• find-item - 在存货中查找特定物品
• equip-item - 装备特定物品

方块交互

• place-block - 在指定坐标放置方块
• dig-block - 在指定坐标挖掘方块
• break-block - 破坏指定坐标方块
• get-block - 获取指定坐标方块的信息

其他

• help - 显示可用命令的列表
• stop - 停止机器人

贡献

欢迎提交拉取请求或打开问题以进行改进。以下是一些可以改进的领域：

• 更多文档
• 更强大的错误处理
• 不同组件的测试
• 新功能和命令