MCP Minecraft Remote

基本能力

产品定位

MCP Minecraft Remote 是一个专为 Minecraft 玩家设计的远程控制工具，通过 AI 助手实现对 Minecraft 服务器的远程控制和自动化操作。

核心功能

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

适用场景

• 自动化 Minecraft 任务
• 远程管理 Minecraft 服务器
• 通过 AI 助手增强游戏体验
• 批量操作和资源管理

工具列表

核心功能

• connectToServer: 连接到 Minecraft 服务器
• disconnectFromServer: 从服务器断开连接
• 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: 与村民交易

常见问题解答

• 服务器在线模式: 服务器必须设置 online-mode=false 才能连接。
• 兼容性: 工具已测试并验证适用于 Minecraft 1.21，其他版本或模组服务器兼容性不保证。

使用教程

使用依赖

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

安装教程

快速安装（推荐）

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

手动安装

# 从 npm 安装
npm install -g mcp-minecraft-remote

# 或克隆仓库
git clone https://github.com/nacal/mcp-minecraft-remote.git
cd mcp-minecraft-remote

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

1. 配置 Claude Desktop 配置文件
2. 添加 Minecraft Remote MCP 配置
3. 保存文件并重启 Claude Desktop
4. 开始新对话并使用 Minecraft 控制命令

配置文件示例（全局安装）:

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。