Minecraft Bedrock

You run a Minecraft Bedrock MCP Server that lets you automate and control World, Player, and world-building tools through an AI-driven interface. It supports natural language commands, advanced building shapes, wiki lookups, and automatic operation sequencing to help you create, explore, and manage Bedrock worlds with ease.

How to use

Connect your MCP client to the local server to start sending commands to Minecraft Bedrock Edition. You can ask it to tell you your coordinates, place specific blocks, build complex shapes, search the Minecraft Wiki for correct block IDs, or control time and weather. Use natural language prompts to chain multiple actions together and let the AI assemble the sequence of tools needed to achieve your goal.

Common usage patterns include querying current state, placing blocks relative to your position, building predefined shapes like spheres or domes, and orchestrating world-wide changes such as night time or rain. If you make a typo or request an invalid block, the system can search the wiki to correct the ID and retry automatically.

How to install

Prerequisites: Node.js version 16 or higher, Minecraft Bedrock Edition (or Education Edition), a world with cheats enabled, and an MCP client for your AI assistant.

git clone https://github.com/Mming-Lab/minecraft-bedrock-education-mcp.git
cd minecraft-bedrock-education-mcp
npm install
npm run build
npm start

Run the server locally

Start the server using the runtime command shown in the setup example for local execution. This runs the MCP server script built for your Bedrock environment.

node C:/path/to/minecraft-bedrock-education-mcp/dist/server.js

Configure your AI client

Add the local MCP server connection to your AI client configuration. This enables the client to route commands to the MCP server for execution in Minecraft.

{
  "mcpServers": {
    "minecraft_bedrock": {
      "command": "node",
      "args": ["C:/path/to/minecraft-bedrock-education-mcp/dist/server.js"]
    }
  }
}

Available tools

player

Manage player state such as position, items, and abilities.

agent

Control agent movement, rotation, and inventory.

blocks

Place, remove, or fill blocks in the world.

world

Control world parameters like time, weather, and rules.

camera

Adjust camera viewpoint, apply fades, and create cinematic effects.

system

Manage UI elements such as scoreboards and on-screen displays.

minecraft_wiki

Search the Minecraft Wiki to find valid block IDs and information.

sequence

Chain multiple tools to execute complex operations automatically.

build_cube

Create hollow or filled cube structures.

build_sphere

Generate spherical shapes with configurable radius.

build_cylinder

Construct cylindrical shapes with a given radius and height.

build_line

Create straight lines of blocks.

build_torus

Build torus (donut shapes) structures.

build_helix

Create spiral or helix structures.

build_ellipsoid

Draw ellipsoids with configurable radii.

build_paraboloid

Shape surfaces following paraboloid equations.

build_hyperboloid

Create hyperboloid shaped structures.

build_bezier

Use Bezier curves to create smooth curved paths.

build_rotate

Apply rotation transforms to existing structures.

build_transform

Apply coordinate transforms to blocks and structures.