minecraft-mcp-server-pixel

🚀 MinecraftBuildMCP 一键部署你的Claude Minecraft Bot

MinecraftBuildMCP 是一个模型上下文协议（MCP）服务器，它能让 Claude（或其他兼容的大型语言模型）借助 Mineflayer 接口对 Minecraft 机器人进行控制。此项目将 AI 语言模型与 Minecraft 相连接，实现自动化建造、探索以及游戏内交互。

🚀 快速开始

MinecraftBuildMCP 能让你通过 AI 语言模型控制 Minecraft 机器人，实现自动化建造与游戏交互。按以下步骤操作，即可快速开启使用之旅。

✨ 主要特性

• AI 驱动的机器人控制：可直接与 Claude Desktop 接口，进而控制 Minecraft。
• 像素艺术生成：能够自动构建复杂的像素艺术设计。
• 导航：可轻松在 Minecraft 世界中移动。
• 方块放置：能精确地在指定坐标放置方块。
• 实体检测：可查找并与游戏内实体进行交互。
• 游戏内聊天：支持发送和接收聊天信息。
• 创造模式支持：涵盖创造模式中的特殊功能，如传送和物品管理。

📦 安装指南

先决条件

• Node.js v16 或更高版本
• Minecraft Java 版本（已测试到 1.21.4）
• Claude Desktop（或其他兼容的 MCP 客户端）

安装步骤

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

   git clone https://github.com/Jeremy-Min-Yang/minecraftbuildmcp.git
   cd minecraftbuildmcp
   npm install
   

2. 配置文件（可选）：
   • 可根据需要修改 config.json 文件，使其适应你的 Minecraft 服务器设置。
3. 运行服务器：

   node index.js
   

💻 使用示例

基础用法

连接到 Minecraft 服务器

• 要确保机器人有权限访问目标 Minecraft 服务器。
• 修改 config.json 中的连接信息，包括服务器地址、端口和身份验证细节。

配置 Claude API 密钥

• 在 config.json 中添加你的 Claude API 密钥，以此启用模型上下文协议交互。

发送指令到机器人

• 利用 Claude 的自然语言处理能力生成命令，并通过 MCP 协议传输给机器人。
• 示例：

  请让机器人在我的 Minecraft 基地建造一座石质桥梁。
  

📚 详细文档

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

🤝 贡献指南

欢迎贡献代码！请按以下步骤提交：

1. Fork 该项目。
2. 创建功能分支（git checkout -b feature/amazing-feature）。
3. 提交修改（git commit -m '添加很棒的功能'）。
4. 推送到分支（git push origin feature/amazing-feature）。
5. 提交 Pull Request。

📄 许可证

本项目遵循 MIT 许可证，详情请见 LICENSE 文件。

👏 致谢

• Mineflayer - 提供强大的 Minecraft 机器人功能
• 模型上下文协议 - 实现 LLM 与工具连接的协议
• Anthropic - Claude AI 的创造者

祝您使用愉快！🤖🏗️