Minecraft Remote

MCP Minecraft Remote lets you control a Minecraft player through an AI assistant, enabling navigation, mining, building, chatting, and interacting with the world on a remote server. It provides a practical bridge between your Minecraft server and an MCP client so you can perform complex in-game actions via natural prompts.

How to use

You connect to a Minecraft server through an MCP client and use natural prompts to control your in-game character. Start by ensuring the server allows non-authenticated access for the bot if needed, and verify you can reach the server from your MCP client. You will issue commands to connect, move, interact with blocks and entities, and manage inventory and containers. The client will translate your prompts into in-game actions such as moving to coordinates, digging blocks, crafting items, trading with villagers, and chatting with other players.

Key capabilities include moving, looking, and sprinting; digging and placing blocks; interacting with containers; crafting items; trading with villagers; following or attacking entities; and communicating via chat. You can check your position, inventory details, nearby players and entities, and server information. Use these commands to perform complex sequences, such as mining a path, crafting a tool, and safely managing inventory while exploring.

How to install

# 1) Install via Smithery (automatic, Claude client)
npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude

# 2) Quick install (recommended)
npx -y @smithery/cli install mcp-minecraft-remote --client claude

If you prefer manual installation, follow these steps to install dependencies, build, and run the project.

# 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

Configuration for client integration

To connect via Claude Desktop, add an MCP server entry to your Claude Desktop configuration. Choose the version you installed and specify the command and arguments exactly as shown in your setup.

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

Server requirements and notes

• The Minecraft server should have online-mode=false in server.properties to allow the bot to connect without authenticating against Minecraft’s session servers.

If you run a server with authentication enabled, you must provide valid premium account credentials when connecting.

Usage prompts and examples

Examples of common prompts include asking the bot to connect to the server, query position, move to coordinates, mine or place blocks, interact with containers, chat with players, craft items, or trade with villagers.

Available tools

connectToServer

Connect to a Minecraft server with specified credentials to begin remote control via MCP.

disconnectFromServer

Terminate the current server connection and end the remote session.

sendChat

Send a chat message to the connected Minecraft server.

getServerInfo

Retrieve information about the connected server, such as version and mode.

getPosition

Query the current player coordinates in the world.

moveTo

Move the player to specific x, y, z coordinates.

moveControl

Issue basic movement commands (forward, back, left, right, jump, sprint, sneak, stop).

lookAt

Rotate the player’s view to face a direction or specific coordinates.

digBlock

Mine a block at given coordinates.

placeBlock

Place a block at given coordinates.

checkInventory

Check current inventory contents.

inventoryDetails

Get detailed information about inventory items.

equipItem

Equip an item from the inventory to hand or armor slot.

tossItem

Drop items from the inventory.

getNearbyPlayers

List nearby players.

getNearbyEntities

List nearby entities.

attackEntity

Attack a specific entity by identifier.

useOnEntity

Use the held item on a specific entity.

followEntity

Follow a specific entity.

openContainer

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

withdrawItem

Withdraw items from an open container.

depositItem

Deposit items into an open container.

closeContainer

Close the currently open container.

getRecipes

Get available crafting recipes.

craftItem

Craft an item using available materials.

listTrades

List trades from a nearby villager.

tradeWithVillager

Trade with a nearby villager.

sendChat

Send a message to the server chat.