Minecraft

🚀 Minecraft MCP 服務器

本項目是一個由大型語言模型和 Mineflayer API 驅動的 Minecraft 機器人。該機器人通過 模型上下文協議（MCP），能讓 Claude 和其他支持的模型控制一個 Minecraft 角色。

🚀 快速開始

此機器人設計用於通過模型上下文協議（MCP）與 Claude Desktop 一起使用。使用前，請確保滿足以下先決條件：

• Node.js
• 正在運行的 Minecraft 遊戲（以下設置經過測試，使用 Microsoft Game Pass 中包含的 Minecraft 1.21.4 Java 版）
• Claude Desktop

運行Minecraft

創建一個單人世界並將其開放到 LAN（ESC -> 打開 LAN 遊戲）。機器人將嘗試連接到端口25565和主機名localhost。這些參數可以在下一步配置在claude_desktop_config.json中。

MCP配置

確保 Claude Desktop 已安裝。打開文件 -> 設置 -> 開發者 -> 編輯配置，它應該會打開安裝目錄。找到名為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 3.7 Sonnet 可能會得到一些有趣的結果。機器人代理會非常聰明 🫡

示例用法：共享 Claude 聊天

⚠️ 重要提示

⚠️ 重要兼容性警告

截至 2025 年 3 月 25 日，Minecraft 1.21.5 剛剛發佈。此機器人目前與 Minecraft 1.21.5 不兼容。請使用 Minecraft 1.21.4 直到我們發佈支持 1.21.5 的更新。

💻 使用示例

連接到 Minecraft 服務器後，Claude 可以使用以下命令：

移動

• get-position - 獲取機器人當前位置
• move-to-position - 移動到特定座標
• look-at - 使機器人看向特定座標
• jump - 讓機器人跳躍
• move-in-direction - 向特定方向移動一段持續時間

存貨

• list-inventory - 列出機器人存貨中的所有物品
• find-item - 在存貨中查找特定物品
• equip-item - 裝備特定物品

方塊交互

• place-block - 在指定座標放置方塊
• dig-block - 在指定座標挖掘方塊
• break-block - 破壞指定座標方塊
• get-block - 獲取指定座標方塊的信息

其他

• help - 顯示可用命令的列表
• stop - 停止機器人

🤝 貢獻

歡迎提交拉取請求或打開問題以進行改進。以下是一些可以改進的領域：

• 更多文檔
• 更強大的錯誤處理
• 不同組件的測試
• 新功能和命令