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 角色。

<a href="https://glama.ai/mcp/servers/@yuniko-software/minecraft-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@yuniko-software/minecraft-mcp-server/badge" alt="mcp-minecraft MCP server" /> </a>

前提条件

• Node.js
• 一个正在运行的 Minecraft 游戏（下面的设置已使用 Microsoft Game Pass 中包含的 Minecraft 1.21.4 Java 版进行测试）
• Claude Desktop

开始使用

此机器人旨在通过模型上下文协议 (MCP) 与 Claude Desktop 一起使用。

运行 Minecraft

创建一个单人游戏世界并将其开放到局域网（ESC -> 开放到局域网）。机器人将尝试使用端口 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 应用程序（应在 OS 托盘中关闭）。

运行

确保 Minecraft 游戏正在运行并且世界已开放到局域网。然后启动 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 - 在指定坐标挖掘方块
• get-block-info - 获取有关方块的信息
• find-block - 查找特定类型的最近方块

实体互动

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

通讯

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

贡献

此应用程序仅在两天内完成，代码非常简单明了。非常感谢所有的重构提交、功能和测试贡献、问题和讨论！

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

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