Minecraft Bedrock MCP Server

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

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

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.

Tools

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

mcp-minecraft
arjunkmrm
-
security
A
license
-
quality
Allows AI models to observe and interact with the Minecraft world through a bot.
Last updated -
13
83
TypeScript
MIT License
MCPMC (Minecraft MCP)
gerred
-
security
A
license
-
quality
Enables AI agents to control Minecraft bots through a standardized JSON-RPC interface.
Last updated -
10
0
33
TypeScript
MIT License
MCP Minecraft Remote
nacal
A
security
A
license
A
quality
Allows 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 -
27
661
9
TypeScript
MIT License
focMCP SDKofficial
focMCP
-
security
-
license
-
quality
Provides tools and infrastructure for building fully on-chain Minecraft Protocol servers that enable developers to create decentralized gaming experiences using blockchain technology.
Last updated -
1
TypeScript
MIT License

View all related MCP servers

Minecraft Bedrock MCP Server