attackEntity
Attack a specific entity
LABSCO SUMMARY
The agent gets a body in the world rather than a console over it.
Everything happens through one logged-in player: it walks, digs, opens the chest in front of it and hands items to a villager, and getNearbyPlayers means other people on the server see the same character. Because credentials go to connectToServer at call time, the server keeps nothing between runs. There is no batch or blueprint primitive — placeBlock takes one coordinate triple, so a structure costs as many calls as it has blocks.
What it is
A remote-control server for one Minecraft player — 27 tools spanning connection, movement, world edits, inventory, containers, crafting and villager trade.
What you get
- A session against any reachable server: connectToServer takes host, port, username, password and version, and disconnectFromServer ends it.
- Movement and aim — moveTo for exact coordinates, moveControl for a basic action held for a duration, lookAt for direction, getPosition to read where the player stands.
- World edits at explicit coordinates through digBlock and placeBlock.
- Inventory handling: checkInventory and inventoryDetails to read it, equipItem to hand or armor slot, tossItem to drop a count of something.
- Container work — openContainer at coordinates, then withdrawItem, depositItem and closeContainer.
- Entity interaction: getNearbyEntities within a range, attackEntity, useOnEntity with the held item, followEntity at a set distance.
- Crafting and commerce — getRecipes, craftItem, listTrades from a nearby villager, and tradeWithVillager by trade index.
Requirements
A reachable Minecraft server and an account on it. The login is passed to connectToServer per session — host, port, username, password and version — so nothing is held in the environment.
Setup effort
One command — npx -y mcp-minecraft-remote@latest
USE CASES
01
Getting a character onto the server and oriented
Log in with the server's host, port and version, read back where the player landed and who else is around, and announce yourself in chat.
02
Cutting a tunnel to a coordinate you picked off a map
Move the player toward the target, clear blocks in the way one coordinate at a time, and check position as you go.
03
Restocking from a chest without abandoning the build
Open the container at its coordinates, take what is needed and drop off what is not, then close it and confirm the inventory.
04
Turning raw material into the tool the job needs
Check what the current materials allow, craft the item, and put it in hand before continuing.
05
Working a villager for the trade you actually want
List what the nearby villager offers, take the trade by its index, and clear inventory space when the exchange needs it.
06
Dealing with something hostile that has come too close
Scan for entities within range, turn to face the one that matters, and either strike it, use the held item on it, or shadow it.
27 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
checkInventory
Check the items in the player inventory
closeContainer
Close the currently open container
connectToServer
Connect to a Minecraft server with the specified credentials
craftItem
Craft an item using available materials
depositItem
Put items into an open container
digBlock
Dig a block at the specified coordinates
disconnectFromServer
Disconnect from the Minecraft server
equipItem
Equip an item from inventory to hand or armor slot
followEntity
Follow a specific entity
getNearbyEntities
Get a list of all entities nearby
getNearbyPlayers
Get a list of players nearby
getPosition
Get the current position of the player in the Minecraft world
getRecipes
Get a list of available crafting recipes
getServerInfo
Get information about the currently connected server
inventoryDetails
Get detailed information about inventory items
listTrades
List available trades from a nearby villager
lookAt
Make the player look in a specific direction or at coordinates
moveControl
Control the player with basic movement commands
moveTo
Move the player to a specific location
openContainer
Open a container (chest, furnace, etc.) at specific coordinates
placeBlock
Place a block at the specified location
sendChat
Send a chat message to the Minecraft server
tossItem
Throw items from inventory
tradeWithVillager
Trade with a nearby villager
useOnEntity
Use held item on a specific entity
withdrawItem
Take items from an open container
BEFORE YOU INSTALL
What to know first
Tools you get
27 tools when we connected.
Requires
- npx on PATH
- Node.js 18+
CONTEXT COST
Light Standing cost
Rated by the size of the 27 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
Connect your client
Add the block to your client, or run the command directly.
Server setup
Configuration file
JSON
{
"mcpServers": {
"mcp-minecraft-remote": {
"command": "npx",
"args": [
"-y",
"mcp-minecraft-remote@latest"
]
}
}
}npx
TERMINAL
npx -y mcp-minecraft-remote@latest
