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