Minecraft Bedrock MCP Server

A TypeScript-based MCP server for controlling Minecraft Bedrock Edition and Education Edition.

Features

Core Tools: Player, Agent, Blocks, World, Camera, System control
Advanced Building: 12 types of 3D shape tools (cube, sphere, helix, torus, bezier curves, etc.)
Wiki Integration: Search Minecraft Wiki for accurate information
Sequence System: Automatic chaining of multiple operations
Natural Language: Control Minecraft with natural language

Quick Start

1. Installation

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

2. Minecraft Connection

Open a world in Minecraft (with cheats enabled), then in chat:

/connect localhost:8001/ws

3. AI Assistant Setup

Add to your MCP client configuration (e.g., Claude Desktop):

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

Claude Desktop: %APPDATA%\Claude\claude_desktop_config.json (Windows) For other MCP clients, refer to their respective documentation.

Available Tools

Core Tools

player - Player management (location, items, abilities)
agent - Agent control (movement, rotation, inventory)
blocks - Block operations (place, remove, fill)
world - World control (time, weather, game rules)
camera - Camera control (viewpoint, fade, cinematic)
system - Scoreboard and UI display
minecraft_wiki - Wiki search
sequence - Multi-tool chaining execution

Building Tools (12 types)

build_cube - Cube (hollow/filled)
build_sphere - Sphere
build_cylinder - Cylinder
build_line - Line
build_torus - Torus (donut)
build_helix - Helix (spiral)
build_ellipsoid - Ellipsoid
build_paraboloid - Paraboloid
build_hyperboloid - Hyperboloid
build_bezier - Bezier curve
build_rotate - Rotation transform
build_transform - Coordinate transform

Usage Examples

Basic Usage

Just talk naturally to the AI assistant:

Tell me my current coordinates → Gets player position Place a diamond block in front of me → Places block Build a glass dome with radius 10 → Sphere building (hollow) Create a spiral staircase with stone bricks → Helix building How many villagers are nearby? → Entity search

Complex Building

I want to build a castle → AI automatically combines multiple tools to build Create a smooth bridge using bezier curves → Natural curved bridge with bezier tool Make it night and start raining → World control (time & weather)

Automatic Error Correction

User: "Place a daimond_block" System: ❌ Unknown block: minecraft:daimond_block 💡 Use the minecraft_wiki tool to search for valid block IDs AI: Let me search the wiki for the correct ID... → Automatically searches for and corrects to "diamond_block"

Technical Specifications

Token Optimization: Automatic data compression (98% reduction)
Error Auto-correction: AI detects and fixes mistakes automatically
Multilingual: Japanese/English support

Requirements

Node.js 16 or higher
Minecraft Bedrock Edition or Education Edition
World with cheats enabled
MCP client (e.g., Claude Desktop)

License

GPL-3.0

Acknowledgments

SocketBE - Minecraft Bedrock WebSocket integration library
Model Context Protocol - AI integration protocol specification
Anthropic - Claude AI and MCP TypeScript SDK

Minecraft Bedrock Education MCP