Minecraft MCP 服务器

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

https://github.com/user-attachments/assets/6f17f329-3991-4bc7-badd-7cde9aacb92f

这是一款由大型语言模型驱动、基于Mineflayer API的Minecraft机器人。该机器人使用模型上下文协议（MCP）来实现Claude及其他支持模型对Minecraft角色的控制。

前置条件

• Git
• Node.js
• 运行的Minecraft游戏（以下设置已在Microsoft Game Pass包含的Minecraft 1.21.4 Java版上测试通过）
• Claude桌面版

入门指南

该机器人设计为通过模型上下文协议（MCP）与Claude桌面版配合使用。

运行Minecraft

创建一个单人游戏世界并开启局域网访问（ESC -> 开启局域网）。机器人将尝试使用端口25565和主机名localhost进行连接。这些参数可以在后续步骤中的claude_desktop_config.json文件中进行配置。

MCP配置

确保已安装Claude桌面版。打开文件 -> 设置 -> 开发者 -> 编辑配置。这应该会打开安装目录。找到名为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桌面应用程序（应在操作系统托盘中关闭）。

运行

确保Minecraft游戏正在运行且世界已开启局域网访问。然后启动Claude桌面应用程序，机器人应该会加入游戏。

Claude桌面应用程序启动MCP服务器可能需要一些时间。服务器成功启动的标志是聊天旁边出现的锤子图标。

您可以通过任何活跃的Claude桌面聊天窗口向机器人发出命令。您还可以上传建筑物的图片并让机器人建造它们 😁

请不要忘记在您的提示中明确说明要让机器人在Minecraft中执行某些操作。因为这是触发MCP服务器运行的关键。它会请求您的权限。

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

示例用法：共享Claude聊天

可用命令

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

移动

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

飞行

• fly-to - 让机器人直接飞到特定坐标

物品栏

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

方块交互

• place-block - 在指定坐标放置方块
• dig-block - 挖掘指定坐标的方块
• get-block-info - 获取方块信息
• find-block - 查找最近的特定类型方块

实体交互

• find-entity - 查找最近的特定类型实体

通信

• send-chat - 在游戏中发送聊天消息

贡献

这个应用程序仅用了两天时间开发，代码非常简单直接。所有重构提交、功能和测试贡献、问题及讨论都非常欢迎！

请随时提交拉取请求或打开问题以提出改进建议。以下是一些可以改进的领域：

• 增加文档
• 更健壮的错误处理
• 不同组件的测试
• 新功能和命令