Minecraft Remote

🚀 Minecraft 遠程控制 MCP 項目

本項目受啟發於 mcp-minecraft 由 arjunkmrm 創建。原項目僅支持本地 Minecraft 服務器連接，而此新項目是從頭開始創建，新增了對遠程 Minecraft 服務器連接的支持。本項目可使用 MCP（模型上下文協議）控制 Minecraft 遊戲。

🚀 快速開始

本項目通過 MCP 協議與 AI 助手（如 Claude）集成，藉助以下操作可快速上手。

配置文件

創建或編輯 config.json 文件，添加以下內容：

{
  "minecraft_server": "play.example.com",
  "username": "player1",
  "password": "your_password"
}

示例命令

• 查詢服務器狀態：query_minecraft_status
• 獲取當前玩家列表：get_players
• 控制玩家移動：move_player x=100 y=64 z=-200

✨ 主要特性

• 通過 AI 助手連接並控制 Minecraft 玩家
• 導航、挖掘、建造並與 Minecraft 世界互動
• 與其他玩家聊天
• 查看庫存、玩家位置和服務器信息
• 高級運動控制，包括跳躍、潛行和疾跑
• 實體交互，包括攻擊和跟隨
• 容器使用（箱子、熔爐等）
• 物品合成與村民交易
• 詳細的庫存管理

📦 安裝指南

快速安裝（推薦）

npx -y @smithery/cli install mcp-minecraft-remote --client claude

按照 CLI 提示完成設置。

手動安裝

1. 下載 Node.js 18+。
2. 安裝 @smithery/cli：

   npm install -g @smithery/cli
   

3. 使用 CLI 安裝項目：

   smithery install mcp-minecraft-remote --client claude
   

📚 詳細文檔

配置文件

創建或編輯 config.json 文件，添加以下內容：

{
  "minecraft_server": "play.example.com",
  "username": "player1",
  "password": "your_password"
}

示例命令

• 查詢服務器狀態：query_minecraft_status
• 獲取當前玩家列表：get_players
• 控制玩家移動：move_player x=100 y=64 z=-200

🔧 技術細節

技術要求

• Node.js 18+
• 支持 MCP 的 AI 助手（如 Claude）
• Minecraft Java 版本 1.8 或更高版本

⚠️ 重要提示

此工具經過測試，確認與原版 Minecraft 1.21 兼容。其他版本或模改服務器的兼容性未經過驗證。

📄 許可證

MIT