minecraft-mcp-server

minecraft-mcp-server 概覽

這是什麼

一個基於 Mineflayer API 的 Minecraft MCP 伺服器。它讓 AI 助手能夠即時控制 Minecraft 角色，透過自然語言指令建造建築、探索世界並與遊戲環境互動。目前支援 Minecraft 1.21.11 版本。

主要功能

• 移動與導航：取得位置、移動到指定座標、看向某點、跳躍、朝特定方向移動、直接飛到某處 - 物品欄管理：列出物品欄、尋找特定物品、裝備物品 - 方塊操作：放置方塊、挖掘方塊、取得方塊資訊、尋找附近特定類型的方塊 - 熔爐冶煉：使用熔爐類方塊冶煉物品 - 實體互動：尋找最近的特定類型實體 - 通訊：在遊戲中發送聊天訊息、讀取其他玩家的最近聊天內容 - 遊戲狀態偵測：偵測目前的遊戲模式

使用情境

• 根據圖片或自然語言描述建造建築物 - 自主探索 Minecraft 世界 - 自動化重複性任務，例如挖礦、合成或耕種 - 用於測試或教育目的與遊戲環境互動

快速開始

前置需求：Git、Node.js（>= 20.10.0）、正在執行的 Minecraft 遊戲（已測試 1.21.8 Java 版）、以及一個相容 MCP 的客戶端（例如 Claude Desktop）。 1. 建立一個單人世界並開放至 LAN（ESC → 開放至 LAN）。機器人會嘗試使用連接埠 25565 與主機名稱 localhost 連線。 2. 編輯 Claude Desktop 的 claude_desktop_config.json，加入以下內容： json { “mcpServers”: { “minecraft”: { “command”: “npx”, “args”: [ “-y”, “github:yuniko-software/minecraft-mcp-server”, “--host”, “localhost”, “--port”, “25565”, “--username”, “ClaudeBot” ] } } } 3. 完全重新啟動 Claude Desktop。 4. 在 Minecraft 世界已開放至 LAN 的狀態下啟動 Claude Desktop，機器人應會加入遊戲。 完整說明請參閱儲存庫的 README。

授權與價格

採用 Apache‑2.0 授權。此專案為開放原始碼且免費使用。

內容整理自該專案公開的 README 與儲存庫資訊。