-
security-
license-
qualityAllows AI models to observe and interact with the Minecraft world through a bot.
Last updated -
9
86
MIT License
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.
Minecraft Bedrock MCP Server
日本語 README はこちら / Japanese README here
A TypeScript MCP server for controlling Minecraft Bedrock Edition and Education Edition.
Features
Reliable Integration: Stable Minecraft control via WebSocket
Hierarchical Tools: Core tools (blocks, player, world) + Advanced building tools
MCP Compatible: Works with Claude Desktop and other MCP clients
Type-safe: Full TypeScript implementation
Quick Start
1. Installation
git clone https://github.com/Mming-Lab/minecraft-bedrock-mcp-server.git
cd minecraft-bedrock-mcp-server
npm install
npm run build
npm start
2. Minecraft Setup
Create world with cheats enabled (Bedrock/Education Edition)
Connect from Minecraft:
/connect localhost:8001/ws
3. Claude Desktop Setup
Add to claude_desktop_config.json:
{
"mcpServers": {
"minecraft-bedrock": {
"command": "node",
"args": ["path/to/dist/server.js"]
}
}
}
Features
Core Tools:
player,agent,world,blocks,camera,system,minecraft_wikiBuilding Tools:
build_cube,build_sphere,build_cylinder,build_line, etc.Wiki Integration: Search Minecraft Wiki for Bedrock/Education Edition info
Sequence Control: Chain multiple tools with timing and error handling
Cross-Tool Sequences: Combine different tools in automated workflows
Usage Examples
Wiki Search
// Step-by-step wiki search to avoid overwhelming responses
{
"action": "sequence",
"steps": [
{"type": "search", "query": "give command", "focus": "commands"},
{"type": "get_page_summary", "title": "Commands/give"},
{"type": "get_section", "title": "Commands/give", "section": "Syntax"}
]
}
Building Sequence
{
"steps": [
{"tool": "player", "type": "teleport", "x": 0, "y": 70, "z": 0},
{"tool": "build_cube", "type": "build", "x1": -5, "y1": 70, "z1": -5, "x2": 5, "y2": 75, "z2": 5, "material": "diamond_block"},
{"tool": "camera", "type": "move_to", "x": 10, "y": 80, "z": 10, "look_at_x": 0, "look_at_y": 72, "look_at_z": 0}
]
}
Development
npm run build # Compile TypeScript
npm run dev # Build and run
npm test # Run test client
Port Configuration
{
"args": ["path/to/dist/server.js", "--port=8002"]
}
Tools
Core Tools
player- Teleport, give items, gamemode, XPagent- Move, build, mine, inventory managementworld- Time, weather, run commandsblocks- Place/fill blocks, query terraincamera- Cinematic shots, smooth movementsystem- Scoreboards, titles, action barsminecraft_wiki- Search wiki for Bedrock/Education infosequence- Chain multiple tools together
Building Tools
build_cube,build_sphere,build_cylinder- Basic shapesbuild_line,build_helix,build_torus- Complex geometrybuild_ellipsoid,build_paraboloid,build_hyperboloid- Advanced shapesbuild_rotate,build_transform- Copy and transform structures
Requirements
Node.js 16+
Minecraft Bedrock/Education Edition with cheats
MCP client (Claude Desktop, etc.)
License
GPL-3.0
Acknowledgments
SocketBE - Minecraft Bedrock WebSocket integration
local-only server
The server can only run on the client's local machine because it depends on local resources.
Tools
A TypeScript-based server that enables AI-powered control of Minecraft Bedrock Edition through 15 powerful tools for player movement, agent operations, world manipulation, and building complex structures.
Related MCP Servers
- -security-license-qualityEnables AI agents to control Minecraft bots through a standardized JSON-RPC interface.Last updated -434MIT License
- Asecurity-licenseAqualityAllows AI assistants to connect to and control Minecraft players on remote servers, enabling navigation, building, mining, inventory management, entity interaction, and chat communication through natural language commands.Last updated -27249MIT License
focMCP SDKofficial
-security-license-qualityProvides tools and infrastructure for building fully on-chain Minecraft Protocol servers that enable developers to create decentralized gaming experiences using blockchain technology.