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

minecraft-bedrock-education-mcp