Minecraft Remote
About
[](https://smithery.ai/server/@nacal/mcp-minecraft-remote) [](https://mseep.ai/app/nacal-mcp-minecraft-remote) # MCP Minecraft Remote > This project is…
Details
- License
- MIT
Explore
- Connect to and control a Minecraft player via an AI assistant
- Navigate, mine, build, and interact with the Minecraft world
- Chat with other players on the server
- Check inventory, player position, and server information
- Advanced movement control including jumping, sneaking, and sprinting
- Entity interaction including attacking and following
- Container usage (chests, furnaces, etc.)
- Item crafting and villager trading
- Detailed inventory management
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Minecraft RemoteCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
- Node.js 18+
- An AI assistant that supports MCP (like Claude)
- A Minecraft Java Edition server (version 1.8 or later)
Note: This tool has been tested and verified to work specifically with vanilla Minecraft 1.21. While it may function with other versions or modded servers, compatibility is not guaranteed.
To install Minecraft Remote Control for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude
npx -y @smithery/cli install mcp-minecraft-remote --client claude
Follow the CLI prompts to complete the setup.
```bash
npm install -g mcp-minecraft-remote
npm install
- "Open the chest at coordinates x=100, y=64, z=200"
- "Take 10 iron ingots from the chest"
- "Put 5 cobblestone in the chest"
- "Close the container"
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
getPosition
Get the current position of the player in the Minecraft world
moveTo
Move the player to a specific location
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
- 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
- getPosition: Get the current position of the player in the Minecraft world
- moveTo: Move the player to a specific location
- 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
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"minecraft remote": {
"minecraft-remote": {
"command": "npx",
"args": [
"-y",
"mcp-minecraft-remote@latest"
]
}
}
}
}McpServers
{
"minecraft-remote": {
"command": "npx",
"args": [
"-y",
"mcp-minecraft-remote@latest"
]
}
}> This project is inspired by mcp-minecraft by arjunkmrm. While the original only supported local Minecraft server connections, this project was newly created from scratch to add support for connecting to remote Minecraft servers.
Minecraft Remote Control using MCP (Model Context Protocol).
Features
- Connect to and control a Minecraft player via an AI assistant
- Navigate, mine, build, and interact with the Minecraft world
- Chat with other players on the server
- Check inventory, player position, and server information
- Advanced movement control including jumping, sneaking, and sprinting
- Entity interaction including attacking and following
- Container usage (chests, furnaces, etc.)
- Item crafting and villager trading
- Detailed inventory management
Installation
Installing via Smithery
To install Minecraft Remote Control for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @nacal/mcp-minecraft-remote --client claude
Quick Install (Recommended)
npx -y @smithery/cli install mcp-minecraft-remote --client claude
Follow the CLI prompts to complete the setup.
Manual Installation
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
