MCP Minecraft 远程控制

该项目受到 arjunkmrm 的 mcp-minecraft 启发。虽然原项目仅支持本地 Minecraft 服务器连接，但本项目是从头开始全新创建的，以添加对远程 Minecraft 服务器连接的支持。

使用 MCP（模型上下文协议）进行 Minecraft 远程控制。

功能

• 通过 AI 助手连接并控制 Minecraft 玩家
• 导航、挖掘、建造和与 Minecraft 世界互动
• 与服务器上的其他玩家聊天
• 检查物品栏、玩家位置和服务器信息
• 高级移动控制，包括跳跃、潜行和冲刺
• 实体互动，包括攻击和跟随
• 使用容器（箱子、熔炉等）
• 制作物品和村民交易
• 详细的物品栏管理

安装

快速安装（推荐）

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

按照 CLI 提示完成设置。

手动安装

# Install from npm
npm install -g mcp-minecraft-remote

# Or clone the repository
git clone https://github.com/nacal/mcp-minecraft-remote.git
cd mcp-minecraft-remote

# Install dependencies
npm install

# Build the project
npm run build

使用方法

与 Claude Desktop 一起使用

1. 导航到 Claude Desktop 配置文件：

   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. 将 Minecraft Remote MCP 配置添加到您的配置文件中：

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "npx",
      "args": ["-y", "mcp-minecraft-remote@latest"]
    }
  }
}

如果您已全局安装：

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "mcp-minecraft-remote"
    }
  }
}

如果您已在本地克隆了仓库：

{
  "mcpServers": {
    "minecraft-remote": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-minecraft-remote/build/index.js"]
    }
  }
}

1. 保存文件并重新启动 Claude Desktop
2. 与 Claude 开始新的对话，并开始使用 Minecraft 控制命令

重要服务器要求

• 服务器在线模式：Minecraft 服务器必须在 server.properties 文件中将 online-mode=false 设置为 false。这允许机器人无需通过 Minecraft 的会话服务器进行身份验证即可连接。
• 如果使用需要身份验证的服务器，在连接时需要提供有效的高级账户凭据。

可用工具

核心功能

• connectToServer：使用指定凭据连接到 Minecraft 服务器
• disconnectFromServer：断开与 Minecraft 服务器的连接
• sendChat：向服务器发送聊天消息
• getServerInfo：获取已连接服务器的信息

移动

• getPosition：获取当前玩家位置
• moveTo：移动到特定坐标
• moveControl：基本移动控制（前进、后退、左转、右转、跳跃、冲刺、潜行、停止）
• lookAt：使玩家朝特定方向或坐标看

世界互动

• digBlock：在特定坐标处挖掘方块
• placeBlock：在特定坐标处放置方块

物品栏管理

• checkInventory：基本物品栏检查
• inventoryDetails：获取关于物品栏物品的详细信息
• equipItem：从物品栏装备物品到手中或护甲槽
• tossItem：从物品栏扔出物品

实体互动

• getNearbyPlayers: 获取附近的玩家列表
• getNearbyEntities: 获取附近的所有实体列表
• attackEntity: 攻击特定实体
• useOnEntity: 对特定实体使用手中的物品
• followEntity: 跟随特定实体

容器交互

• openContainer: 打开指定坐标的容器（如箱子、熔炉等）
• withdrawItem: 从打开的容器中取出物品
• depositItem: 将物品放入打开的容器
• closeContainer: 关闭当前打开的容器

制作

• getRecipes: 获取可用的制作配方列表
• craftItem: 使用可用材料制作物品

交易

• listTrades: 列出附近村民提供的交易
• tradeWithVillager: 与附近的村民进行交易

示例指令

基本控制

• "使用用户名 player1 连接到 play.example.com 的 Minecraft 服务器"
• "我在游戏中的当前位置是什么？"
• "将我移动到坐标 x=100, y=64, z=-200"
• "让我向前走3秒"
• "让我跳跃并冲刺向那座山"

库存和物品

• "详细检查我的库存"
• "将我的钻石剑装备到手中"
• "从我的库存中扔出5个泥土块"

方块交互

• "挖掘坐标 x=10, y=65, z=20 的方块"
• "在坐标 x=11, y=65, z=20 处放置一个石头方块"

实体交互

• "附近有其他玩家吗？"
• "在我周围20格内有哪些实体？"
• "攻击 ID 为 12345 的僵尸"
• "跟随名为 Steve 的玩家"

容器使用

• "打开坐标 x=100, y=64, z=200 的箱子"
• "从箱子里取出10个铁锭"
• "将5个圆石放入箱子"
• "关闭容器"

制作和交易

• "我有什么可用的木制镐的配方？"
• "使用库存中的木头制作4根木棍"
• "查看附近的村民提供哪些交易"
• "与村民交易以获得10个绿宝石"

交流

• "向聊天发送一条问候消息"
• "告诉大家我找到了钻石"

需求

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

注意：此工具已经过测试，并确认特别适用于原版 Minecraft 1.21。虽然它可能与其他版本或带有模组的服务器兼容，但不保证完全兼容。

许可证

MIT