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

Related Links

• Official MCP Specification
• Socket-BE GitHub
• Minecraft Wiki
• Glama MCP Servers