MinecraftBuildMCP

MinecraftBuildMCP

MinecraftBuildMCP 是一个模型上下文协议（MCP）服务，可通过 Mineflayer API 让 Claude（或其他兼容的大模型）控制 Minecraft 机器人。本项目搭建了 AI 语言模型与 Minecraft 之间的桥梁，让你能够通过自然语言自动化建造、探索并与 Minecraft 世界交互。

🌟 功能

• AI 驱动的机器人控制：直接连接 Claude Desktop 来控制 Minecraft
• 像素画创作：自动建造复杂的像素画设计
• 导航：轻松在 Minecraft 世界中移动
• 放置方块：在指定坐标精确放置方块
• 实体检测：查找实体并与环境交互
• 游戏内聊天：发送和接收聊天消息
• 创造模式支持：支持传送和操作物品栏等创造模式专属功能

📋 前提条件

• Node.js v16 或更高版本
• Minecraft Java Edition（已在版本 1.21.4 上测试）
• Claude Desktop（或任何兼容的 MCP 客户端）

🔧 安装

1. 克隆仓库并安装依赖项：

   git clone https://github.com/Jeremy-Min-Yang/minecraft-mcp-server-pixel.git
   cd minecraft-mcp-server-pixel
   npm install
   

2. 构建项目：

   npm run build
   

🚀 运行机器人

1. 启动 Minecraft 并将世界开放至局域网：

   • 启动 Minecraft 1.21.4
   • 创建新世界或打开现有世界
   • 为获得最佳效果，请使用创造模式
   • 按 Esc，点击“对局域网开放”
   • 启用作弊并设置游戏模式
   • 点击“创建局域网世界”，并记下端口号

2. 在本地运行机器人：

   node dist/bot.js --host localhost --port 25565 --username Bob_the_Builder
   

   或使用 npx 直接从 GitHub 运行：

   npx -y github:Jeremy-Min-Yang/minecraft-mcp-server-pixel --host localhost --port 25565 --username Bob_the_Builder
   

3. 命令行选项：

   • --host：Minecraft 服务主机名（默认值：localhost）
   • --port：Minecraft 服务端口（默认值：25565）
   • --username：机器人的用户名（默认值：Bob_the_Builder）

🔌 Claude Desktop 集成

将以下内容添加到 claude_desktop_config.json，以启用 Minecraft MCP 服务：

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:Jeremy-Min-Yang/minecraft-mcp-server-pixel",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "Bob_the_Builder"
      ]
    }
  }
}

🛠️ 可用命令

连接后，Claude 可以使用以下命令控制 Minecraft 机器人：

移动

• get-position — 获取机器人的当前位置
• move-to-position — 移动到指定坐标（在创造模式下会传送）

物品栏

• equip-item — 将物品装备到机器人的手上
• get-bot-status — 显示当前游戏模式和 OP 状态
• list-block-names — 列出此 Minecraft 版本中所有有效的方块名称

方块交互

• place-block — 在指定坐标放置方块

实体交互

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

聊天

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

像素画

• build-pixel-art — 根据方块类型组成的二维数组建造像素画

🎨 像素画示例

要创建像素画，请提供方块类型组成的二维数组、原点和方向：

// Example pixel art command
{
  "pixels": [
    ["wool_red", "wool_red", "wool_red"],
    ["wool_blue", "wool_white", "wool_blue"],
    ["wool_blue", "wool_blue", "wool_blue"]
  ],
  "origin": { "x": 100, "y": 64, "z": 100 },
  "direction": "north"
}

📚 文档

• 详细的 API 文档请参阅 schema.md
• 有关底层机器人 API 的更多信息，请参阅 Mineflayer 文档：Mineflayer 文档

🤝 参与贡献

欢迎贡献！请随时提交 Pull Request。

1. 复刻项目
2. 创建功能分支（git checkout -b feature/amazing-feature）
3. 提交更改（git commit -m 'Add some amazing feature'）
4. 推送到分支（git push origin feature/amazing-feature）
5. 发起 Pull Request

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

👏 致谢

• Mineflayer - Minecraft 机器人库
• Model Context Protocol - 将大模型连接到工具的协议
• Anthropic - Claude AI 的创造者

---

祝你愉快地使用 AI 构建！🤖🏗️