@iflow-mcp/mming-lab-minecraft-bedrock-education-mcp
v1.0.0
Published
TypeScript-based MCP server for controlling Minecraft Bedrock Edition and Education Edition via WebSocket with hierarchical tools for player, agent, world, and building operations
Readme
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
