Minecraft MCP Server Pixel

🚀 MinecraftBuildMCP - 一鍵部署你的Claude Minecraft Bot

MinecraftBuildMCP 是一個模型上下文協議（MCP）服務器，它能讓 Claude（或其他兼容的大型語言模型）通過 Mineflayer 接口控制 Minecraft 機器人。該項目將 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 的創造者。

祝您使用愉快！🤖🏗️