attackSomeone
Attack, kill, defend against, or initiate combat with someone
LABSCO SUMMARY
Writing the movement, inventory and combat layer yourself before a bot can chop a tree.
The verbs are the game's own — mine, craft, smelt, equip, hunt, sleep — so an instruction like keeping a furnace fed is a sequence of calls rather than a pathfinding problem. lookAround is what holds it together: without a text view of the surroundings the rest would need coordinates you do not have. The two building tools stand apart because they need cheats or operator permissions, and pixel art stops at 256x256 blocks.
What it is
A Minecraft bot client with 32 tools: joining a server, moving, fighting, gathering, crafting, farming, building and reading and writing chat.
What you get
- A bot spawned onto a host, port and username, and disconnected one at a time or all at once
- A text description of the surroundings, which is what makes the other tools usable without a screen
- Movement to coordinates or to a named player, with an option to keep following
- Gathering and processing: mine a resource, harvest mature crops in a radius, till land for farming, smelt or cook with a named fuel, and retrieve what a furnace finished
- Inventory handling — equip, drop, pick up, place, give to a player, open a chest — and crafting by item and count
- Survival behaviour: eat, rest, sleep in a nearby bed, swim to land, run from a threat, hunt, and attack a named target
- Structures built from a command script, and pixel art converted from an image up to 256x256 blocks, both requiring cheats or operator permissions
- Chat read with filters by type, username and time limit, and sent as a message, a command or a whisper
Requirements
A Minecraft server to join — joinGame takes a host, port and username. buildSomething and buildPixelArt need cheats or operator permissions on that server.
Setup effort
One command — npx -y @fundamentallabs/minecraft-mcp
USE CASES
01
Putting a bot on a server and having it describe what it sees
Join with a host, port and username, get a text description of the surroundings, and read what has been said in chat — the three calls that make everything after them possible.
02
Running a farm loop unattended
Till the ground, harvest what has matured within a radius, pick up what dropped, and mine the blocks the next cycle needs.
03
Smelting a batch of ore
Feed the furnace with a named fuel, cook or smelt the stack, and collect the output once it is done.
04
Keeping the bot alive while it works
Eat, rest and sleep on a schedule, get out of the water, and run rather than fight when the target is bigger than the bot.
05
Building something from a script
Structures come from an array of Minecraft commands, and an image becomes pixel art in coloured blocks up to 256x256. Both need cheats or operator permissions on the server.
06
Playing alongside a human player
Follow a named player, hand over the items they asked for, and answer in chat — including whispers and slash commands.
32 tools
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
buildPixelArt
Build pixel art from an image in Minecraft (requires cheats/operator permissions). Converts an image to pixel art using colored blocks. Maximum size is 256x256 blocks.
buildSomething
Build structures using Minecraft commands (requires cheats/operator permissions). Supports two modes: 1) buildScript - array of command objects like [{"command": "fill", "x1": 0, "y1": 64, "z1": 0, "x2": 10, "y2": 70, "z2": 10, "block": "stone"}], 2) code - JavaScript string for dynamic building like "for(let i = 0; i < 10; i++) { setBlock(pos.x + i, pos.y, pos.z, 'stone'); }"
cookItem
Cook an item in a furnace
craftItems
Craft items using a crafting table or inventory
dance
Make the bot dance by moving and jumping
dropItem
Drop items from inventory
eatFood
Eat food from inventory to restore hunger
equipItem
Equip an item (armor, tool, or weapon)
giveItemToSomeone
Give items to another player
goToKnownLocation
Navigate to specific coordinates
goToSomeone
Navigate to another player
harvestMatureCrops
Harvest mature crops from nearby farmland
hunt
Hunt animals or mobs
joinGame
Spawn a bot into the Minecraft game
leaveGame
Disconnect a bot from the game
lookAround
Look around and observe the environment, providing a detailed text-based view of surroundings
mineResource
Mine specific blocks or resources
openInventory
Open the bot's inventory
openNearbyChest
Open a nearby chest
pickupItem
Pick up items from the ground
placeItemNearYou
Place a block or item near the bot
prepareLandForFarming
Prepare land for farming by tilling soil
readChat
Read recent chat messages from the server. Returns player messages, system messages, whispers, action bar messages, and titles.
rest
Rest to regain health
retrieveItemsFromNearbyFurnace
Retrieve smelted items from a nearby furnace
runAway
Run away from a threat
sendChat
Send chat messages or commands to the server. Can send regular messages, commands (starting with /), or whispers.
sleepInNearbyBed
Find and sleep in a nearby bed
smeltItem
Smelt items in a furnace
swimToLand
Swim to the nearest land when in water
useItemOnBlockOrEntity
Use an item on a block or entity
BEFORE YOU INSTALL
What to know first
Tools you get
32 tools when we connected.
Requires
- npx on PATH
- Node.js >= 18.0.0
CONTEXT COST
Light Standing cost
Rated by the size of the 32 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": {
"minecraft-mcp": {
"command": "npx",
"args": [
"-y",
"@fundamentallabs/minecraft-mcp"
]
}
}
}npx
TERMINAL
npx -y @fundamentallabs/minecraft-mcp
