Minecraft Bedrock MCP Server
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.
Provides a runtime environment for the MCP server, with specific version requirements (Node.js 16+) for proper operation.
The MCP server is implemented in TypeScript, offering type-safe implementation with comprehensive error handling for Minecraft Bedrock Edition control.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Minecraft Bedrock MCP Serverbuild a glass dome with radius 10 around my current location"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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
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 start2. Minecraft Connection
Open a world in Minecraft (with cheats enabled), then in chat:
/connect localhost:8001/ws3. 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 displayminecraft_wiki- Wiki searchsequence- Multi-tool chaining execution
Building Tools (12 types)
build_cube- Cube (hollow/filled)build_sphere- Spherebuild_cylinder- Cylinderbuild_line- Linebuild_torus- Torus (donut)build_helix- Helix (spiral)build_ellipsoid- Ellipsoidbuild_paraboloid- Paraboloidbuild_hyperboloid- Hyperboloidbuild_bezier- Bezier curvebuild_rotate- Rotation transformbuild_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 searchComplex 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
Related Links
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/Mming-Lab/minecraft-bedrock-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server