MCP 服务器

MCP Minecraft Remote

允许人工智能助手连接和控制远程服务器上的 Minecraft 玩家，从而可以通过自然语言命令实现导航、建造、挖掘、库存管理、实体互动和聊天通信。

Tools

getPosition

Get the current position of the player in the Minecraft world

moveTo

Move the player to a specific location

connectToServer

Connect to a Minecraft server with the specified credentials

disconnectFromServer

Disconnect from the Minecraft server

sendChat

Send a chat message to the Minecraft server

moveControl

Control the player with basic movement commands

lookAt

Make the player look in a specific direction or at coordinates

digBlock

Dig a block at the specified coordinates

placeBlock

Place a block at the specified location

getNearbyPlayers

Get a list of players nearby

getServerInfo

Get information about the currently connected server

checkInventory

Check the items in the player inventory

equipItem

Equip an item from inventory to hand or armor slot

inventoryDetails

Get detailed information about inventory items

tossItem

Throw items from inventory

getNearbyEntities

Get a list of all entities nearby

attackEntity

Attack a specific entity

useOnEntity

Use held item on a specific entity

followEntity

Follow a specific entity

openContainer

Open a container (chest, furnace, etc.) at specific coordinates

withdrawItem

Take items from an open container

depositItem

Put items into an open container

closeContainer

Close the currently open container

getRecipes

Get a list of available crafting recipes

craftItem

Craft an item using available materials

listTrades

List available trades from a nearby villager

tradeWithVillager

Trade with a nearby villager

README

MCP Minecraft 远程控制

本项目灵感来源于 arjunkmrm 的 mcp-minecraft。虽然原项目仅支持本地 Minecraft 服务器连接，但本项目从头开始创建，增加了对连接远程 Minecraft 服务器的支持。

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

功能

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

安装

快速安装 (推荐)

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

按照 CLI 提示完成设置。

手动安装

# 从 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

使用

与 Claude Desktop 一起使用

导航到 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
将 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"]
    }
  }
}