Fundamental Labs

You can run and connect to a Minecraft MCP server to control bots, automate tasks, and integrate with MCP clients. This server lets you spawn bots, navigate, mine, craft, build, chat, and more, all through a standardized tool you can run locally or remotely.

How to use

Start by launching the MCP server and then connect your MCP client or Claude Desktop to control one or more bots. You can spawn bots, have them move to locations, gather resources, craft items, build structures, and interact with other players. Use the command line options to set a default host and port, or specify them per bot when spawning. The server exposes a consistent set of actions (tools) that you call from your MCP client to perform tasks in-game.

How to install

Prerequisites: you need Node.js version 18 or newer. You also need a Minecraft Java Edition server to connect to.

Install the MCP server globally so you can run it from anywhere:

npm install -g @fundamentallabs/minecraft-mcp

Or run it directly with npx without a global install (recommended for quick trials):

npx --y -- @fundamentallabs/minecraft-mcp

Starting the server with no defaults means you provide connection details per bot. To start with default connection settings you can pass host and port:

minecraft-mcp -h play.example.com -p 25565

Other setup options

If you prefer to run from source, clone the project, install dependencies, and build the client and server components. Then start the MCP server from the built distribution.

Clone, install, and build (example steps):

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 username and optional host/port to connect the bot to a specific server.

leaveGame

Disconnect a bot or all bots from the game. Can target a specific bot by username or disconnect all when requested.

goToSomeone

Navigate a bot to another player's position.

goToKnownLocation

Navigate a bot to specific coordinates (x, y, z).

runAway

Make the bot move away from threats or danger.

swimToLand

Command a bot to swim toward the nearest land when in water.

attackSomeone

Command a bot to attack a target (player, mob, or animal).

hunt

Order a bot to hunt animals or hostile mobs.

mineResource

Mine specific blocks or resources.

harvestMatureCrops

Harvest mature crops from farmland.

pickupItem

Pick up items that are on the ground.

craftItems

Craft items using a crafting table configuration.

cookItem

Cook items in a furnace.

smeltItem

Smelt items in a furnace.

retrieveItemsFromNearbyFurnace

Retrieve smelted items from a nearby furnace.

openInventory

Open the bot's inventory.

equipItem

Equip armor, tools, or weapons.

dropItem

Drop items from the bot's inventory.

giveItemToSomeone

Give items to another player.

placeItemNearYou

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

prepareLandForFarming

Prepare land for farming (tilt/plant).

useItemOnBlockOrEntity

Use an item on a block or an entity.

eatFood

Eat food to restore hunger.

rest

Rest to regain health.

sleepInNearbyBed

Find and sleep in a nearby bed.

openNearbyChest

Open a nearby chest to access items.

dance

Make the bot perform a dance action for fun or signaling.

lookAround

Look around to observe the environment.

readChat

Read recent chat messages from the server.

sendChat

Send chat messages or commands to the server.

buildSomething

Build structures using Minecraft commands or dynamic code (requires operator permissions).

buildPixelArt

Build pixel art from an image in Minecraft (requires operator permissions).