chatLABSCO SUMMARY
A body in the world, not a chat command — the bot observes, moves and changes blocks.
The tool set is the loop an actual player runs: read the surroundings, move to a spot, look at it, then dig or place. That makes it usable for building and fetching tasks rather than just for issuing world commands.
What it is
A bridge to a running Minecraft server through a bot: movement and orientation, block inspection and manipulation, inventory handling, and awareness of nearby players and mobs.
What you get
- Movement — forward, back, turning, and travel to a named position
- Orientation: look at a point, and read the bot's own status
- The world read: information about a specific block, and the entities nearby
- Blocks broken and placed
- Inventory read, a hotbar slot selected, and an item equipped
- Items used and released, and a player followed or dropped
Requirements
A Minecraft server v1.21 running locally from a server.jar whose absolute path you pass on the launch command, a Java runtime, Node.js, and Minecraft Java Edition v1.21 to join with. Tested on macOS and Linux; Windows is not guaranteed. Turn off 'Pause on Lost Focus' with F3+P, or the world stops while you are in the chat window.
Setup effort
Build from source
USE CASES
01
Having something built while you do other things
Send the bot to the site, then place blocks from its inventory in the pattern you described.
02
Clearing a space to build in
Check what a block is before breaking it, then dig out the area.
03
Scouting terrain you have not walked yet
Move and turn, look at what is ahead, and read back what entities are around.
04
Getting a companion that tags along
Have the bot follow you while you explore, and stop it when you want it to stay put.
05
Using the right tool for a job
Select the hotbar slot, equip the item, use it, and release it when the action is done.
21 tools
Listed in project docs. Your client may show a different list.
jumpmoveForwardmoveBackturnLeftturnRightplaceBlockdigBlockgetBlockInfoselectSlotgetInventoryequipItemgetStatusgetNearbyEntitiesattackuseItemstopUsingItemlookAtfollowPlayerstopFollowinggoToPositionBEFORE YOU INSTALL
What to know first
Tools you get
21 tools named in the project's documentation.
Requires
npx on PATH
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
MCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"mcp-minecraft": {
"command": "npx",
"args": [
"-y",
"mcp-minecraft@latest",
"--server-jar",
"<YOUR_PATH_TO_MINECRAFT_SERVER>/server.jar"
]
}
}
}
