Fundamental Labs

You use this MCP server to connect AI agents to Minecraft, control bots, and perform a wide range of in-game tasks through pre-built skills. It supports multi-bot setups, flexible server connections, and MCP compatibility with clients like Claude Desktop, enabling automation and experimentation in Minecraft worlds.

How to use

Start by running the MCP server to accept connection from your MCP client. You can spawn bots, send them to mine resources, navigate to coordinates, craft items, build structures, and interact with the world through the available skills. Use your MCP client to call the skills listed under “Skills” to perform actions. You can operate multiple bots simultaneously and configure each bot’s connection settings as needed.

How to install

Prerequisites: Node.js v18 or newer, a Java Edition Minecraft server to connect to, and an MCP-compatible client.

Direct command via npx (recommended) is available to run the MCP server without local installation of dependencies.

Install globally with npm (recommended for local workflows):

Install steps (concrete commands)

# Start the MCP server with no defaults (connection specified per bot)
minecraft-mcp

# Start the MCP server with default connection settings
minecraft-mcp -h play.example.com -p 25565

Alternative installation paths

From source, you can build the server locally and run it from the dist output. Use a clone path and then build, as shown in the example.

git clone https://github.com/FundamentalLabs/minecraft-mcp.git
cd minecraft-mcp/minecraft-client/mcp-server
npm install
npm run build

Available tools

joinGame

Spawn a new bot into the Minecraft game. Requires a username and optional host/port for the target server.

leaveGame

Disconnect bot(s) from the game. You can target a specific bot or disconnect all bots.

goToSomeone

Navigate a bot to another player in the world.

goToKnownLocation

Navigate a bot to specific x/y/z coordinates.

runAway

Make a bot retreat from threats or danger.

swimToLand

Swim towards the nearest land when the bot is in water.

attackSomeone

Engage a target (player, mob, or animal) for combat.

hunt

Pursue and eliminate animals or mobs.

mineResource

Mine specific blocks or resources.

harvestMatureCrops

Harvest fully grown crops from farmland.

pickupItem

Pick up items dropped on the ground.

craftItems

Craft items using a crafting table and available resources.

cookItem

Cook items in a furnace.

smeltItem

Smelt items in a furnace.

retrieveItemsFromNearbyFurnace

Retrieve smelted items from an adjacent furnace.

openInventory

Open the bot's inventory to manage items.

equipItem

Equip armor, tools, or weapons on the bot.

dropItem

Drop items from the bot’s inventory.

giveItemToSomeone

Give items to another player.

placeItemNearYou

Place blocks near the bot to build or shape the world.

prepareLandForFarming

Prepare land for farming (tilt, seed, etc.).

useItemOnBlockOrEntity

Use a held item on a block or entity.

eatFood

Consume food to restore hunger.

rest

Rest to regain health.

sleepInNearbyBed

Find and sleep in a nearby bed.

openNearbyChest

Open a nearby chest to access stored items.

dance

Make the bot perform a dance animation.

lookAround

Survey the environment by looking around.

readChat

Read recent chat messages from the server.

sendChat

Send a chat message or command to the server.

buildSomething

Build structures using Minecraft commands or dynamic JavaScript code (requires operator privileges). Supports static command arrays and dynamic scripting.

buildPixelArt

Build pixel art from an image in Minecraft (requires operator privileges). Converts an image to colored blocks; maximum size is 256x256.