A TypeScript-based MCP server that enables AI assistants to control Minecraft Bedrock and Education Editions through natural language commands via WebSocket connection.

Player & Agent Management: Control player attributes (location with negative coordinate support, gamemode, abilities like mayfly/mute/worldbuilder, inventory, XP levels, tags) and direct the in-game Agent for automated movement, mining, building, and inventory operations.

Advanced 3D Construction (12 types): Build complex geometric shapes including cubes, spheres, cylinders, lines, toruses (donuts/rings), helices (spiral staircases), ellipsoids, paraboloids (satellite dishes), hyperboloids (cooling towers), and Bezier curves for smooth paths.

Structural Manipulation: Transform existing structures through rotation, mirroring, copying, and scaling operations.

World & Block Control: Manage time (0-24000 ticks), weather (clear/rain/thunder), game rules, and execute raw Minecraft commands. Place/fill blocks with multiple modes (replace/keep/destroy/hollow/outline) and query block data.

Cinematic Camera System: Program camera movements (instant/smooth), track entities, create fade effects, and execute multi-shot sequences with easing options.

System & UI Features: Manage scoreboards, display titles/subtitles/action bars, send chat messages, and control screen elements.

Smart Automation: Chain operations across tools using the sequence system with timing control and error handling (continue/stop/retry). Built-in error auto-correction detects mistakes and searches the Minecraft Wiki for accurate command syntax, block IDs, and game mechanics (Bedrock/Education Edition only). Token optimization provides 98% data compression for efficient processing.

Minecraft Bedrock MCP Server

日本語版 README はこちら / Japanese README here

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

Related MCP server: MCPMC (Minecraft MCP)

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 MCP Server

Minecraft Bedrock MCP Server

Features

Quick Start

1. Installation

2. Minecraft Connection

3. AI Assistant Setup

Available Tools

Core Tools

Building Tools (12 types)

Usage Examples

Basic Usage

Complex Building

Automatic Error Correction

Technical Specifications

Requirements

License

Acknowledgments

Related Links

Resources

Tools

New MCP Servers

Latest Blog Posts

MCP directory API