# Minecraft 远程控制工具
## 基本信息
- Slug: `nacal-mcp-minecraft-remote`
- Source: modelscope
- Publisher: @nacal/mcp-minecraft-remote
- Categories: games-and-gamification / os-automation
- Hosted: Yes
- License: MIT License
- Source URL: https://www.modelscope.cn/mcp/servers/@nacal/mcp-minecraft-remote
## 简介
允许AI助手连接到远程服务器上的Minecraft玩家并对其进行控制，通过自然语言命令实现导航、建造、挖掘、库存管理、实体交互和聊天通信等功能。
## 安装提示

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

## MCP Server 详情

# MCP Minecraft 远程控制

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

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

## 功能

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

## 安装

### 快速安装（推荐）

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


按照 CLI 提示完成设置。

### 手动安装

```bash
# 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 配置添加到您的配置文件中：

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


如果您已全局安装：

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


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

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


3. 保存文件并重新启动 Claude Desktop
4. 与 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