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

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

Minecraft Setup

Create world with cheats enabled (Bedrock/Education Edition)
Connect from Minecraft: /connect localhost:8001/ws

Claude Desktop Setup

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "minecraft-bedrock": {
      "command": "node",
      "args": ["path/to/dist/server.js"]
    }
  }
}

Available Tools

Core Tools

agent - Agent control (move, turn, teleport, inventory)
player - Player management (info, items, abilities)
world - World control (time, weather, commands)
blocks - Block operations (set, fill, query)
system - Scoreboard and UI controls

Building Tools

build_cube - Boxes and hollow structures
build_sphere - Spheres and domes
build_cylinder - Towers and pipes
build_line - Straight line construction
build_torus - Donut shapes
build_helix - Spiral structures
build_ellipsoid - Egg shapes
build_paraboloid - Satellite dishes
build_hyperboloid - Cooling towers
build_rotate - Structure rotation
build_transform - Structure transformations

Development

Build Commands

npm run build    # Compile TypeScript
npm run dev      # Build and run for testing

Port Configuration

Configure port in MCP client settings:

{
  "mcpServers": {
    "minecraft-bedrock": {
      "command": "node",
      "args": ["path/to/dist/server.js", "--port=8002"]
    }
  }
}

Architecture

src/
├── server.ts           # Main MCP server
├── types.ts           # Type definitions
└── tools/
    ├── base/tool.ts   # Base class
    ├── core/          # Core API tools
    └── advanced/      # Building tools

License

GPL-3.0

Acknowledgments

SocketBE - Minecraft Bedrock WebSocket integration library

Requirements

Node.js 16+
Minecraft Bedrock Edition or Education Edition with cheats
MCP client (Claude Desktop, etc.)

This server cannot be installed

security - not tested

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.

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 -
31
82
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
2
32
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
175
8
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