Minecraft MCP Server

Minecraft MCP Server

---

重要

目前支持 Minecraft 版本 1.21.11。较新版本可能无法与此 MCP 服务配合使用，但我们会尽快添加支持。

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

这是一款由大模型和 Mineflayer API 驱动的 Minecraft 机器人。该机器人使用 Model Context Protocol（MCP），让 Claude 和其他受支持的模型能够控制 Minecraft 角色。

前置要求

• Git
• Node.js（>= 20.10.0）
• 正在运行的 Minecraft 游戏（以下设置已在 Microsoft Game Pass 中包含的 Minecraft 1.21.8 Java Edition 上测试）
• 兼容 MCP 的客户端。本文以 Claude Desktop 为例，也支持其他 MCP 客户端

开始使用

此机器人通过 Model Context Protocol（MCP）与 Claude Desktop 配合使用。

运行 Minecraft

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

MCP 配置

确保已安装 Claude Desktop。打开 File -> Settings -> Developer -> Edit Config。这应该会打开安装目录。找到名为 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 Sonnet 可能会带来一些有趣的结果。这个机器人 Agent 会非常聪明 🫡

使用示例：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-blocks - 查找附近一个或多个特定类型的方块

熔炉

• smelt-item - 使用类似熔炉的方块熔炼物品

实体交互

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

通信

• send-chat - 在游戏中发送聊天消息
• read-chat - 获取玩家最近发送的聊天消息

游戏状态

• detect-gamemode - 检测游戏模式

贡献

欢迎提交拉取请求或提出问题，帮助改进项目。我们非常感谢所有重构提交、功能和测试贡献、问题反馈及讨论！

如需开始贡献，请参阅 CONTRIBUTING.md。

---

⭐ 如果你觉得这个项目有用，请考虑在 GitHub 上为它点亮一颗星！⭐

你的支持有助于让更多可能从中受益的人发现这个项目。