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