Skip to main content
Glama

Minecraft Bedrock Education MCP

by Mming-Lab
GitHub
TypeScript
GPL 3.0
7
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

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-education-mcp.git cd minecraft-bedrock-education-mcp npm install npm run build npm start

2. Minecraft Setup

  1. Create world with cheats enabled (Bedrock/Education Edition)

  2. 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_wiki

  • Building 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, XP

  • agent - Move, build, mine, inventory management

  • world - Time, weather, run commands

  • blocks - Place/fill blocks, query terrain

  • camera - Cinematic shots, smooth movement

  • system - Scoreboards, titles, action bars

  • minecraft_wiki - Search wiki for Bedrock/Education info

  • sequence - Chain multiple tools together

Building Tools

  • build_cube, build_sphere, build_cylinder - Basic shapes

  • build_line, build_helix, build_torus - Complex geometry

  • build_ellipsoid, build_paraboloid, build_hyperboloid - Advanced shapes

  • build_bezier - Smooth Bezier curves (bridges, arches, decorative paths) 🆕

  • build_rotate, build_transform - Copy and transform structures

Multilingual Support (i18n)

Error messages support English and Japanese:

# Start with Japanese npm start -- --lang=ja # Start with English npm start -- --lang=en # Auto-detect (system language) npm start

Claude Desktop configuration:

{ "mcpServers": { "minecraft-bedrock-education": { "args": ["path/to/dist/server.js", "--lang=ja"] } } }

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

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

local-only server

The server can only run on the client's local machine because it depends on local resources.

Enables controlling Minecraft Bedrock and Education Edition through natural language commands via WebSocket connection. Provides tools for player actions, world manipulation, building structures, camera control, and wiki integration for automated gameplay and educational scenarios.

  1. Features
    1. Quick Start
      1. 1. Installation
      2. 2. Minecraft Setup
      3. 3. Claude Desktop Setup
    2. Features
      1. Usage Examples
        1. Wiki Search
        2. Building Sequence
      2. Development
        1. Port Configuration
      3. Tools
        1. Core Tools
        2. Building Tools
      4. Multilingual Support (i18n)
        1. Requirements
          1. License
            1. Acknowledgments

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/Mming-Lab/minecraft-bedrock-education-mcp'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server