MCPETool
get/put/delete cli and http API for Minecraft Bedrock Edition world directories
What is MCPETool?
MCPETool is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to get/put/delete cli and http api for minecraft bedrock edition world directories
get/put/delete cli and http API for Minecraft Bedrock Edition world directories
This server falls under the File Systems category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- get/put/delete cli and http API for Minecraft Bedrock Editio
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcpetoolConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use MCPETool
MCPETool is an offline Go utility for reading and writing world data from Minecraft Bedrock Edition saves without requiring the game to be running. It exposes both a command-line interface and an HTTP REST API that give developers direct key-value access to the underlying LevelDB database and the level.dat configuration file. Modders, tool builders, and server admins can use it to programmatically inspect, back up, or modify world state — including chunk data, game settings, and player records — through familiar JSON and base64-encoded formats.
Prerequisites
- Go 1.18 or later to build from source
- A Minecraft Bedrock Edition world directory (the game does not need to be running)
- An MCP-compatible AI client if using via Model Context Protocol integration
- Basic familiarity with LevelDB key-value concepts for advanced database access
- curl or any HTTP client if you plan to use the REST API
Clone and build MCPETool
MCPETool is distributed as source code and must be compiled with Go. Clone the repository and build the binary.
git clone https://github.com/midnightfreddie/McpeTool
cd McpeTool
go build ./cmd/mcpetoolSet your world path
Set the MCPETOOL_WORLD environment variable to avoid passing --path with every command. On Windows, Bedrock worlds are typically found in the path shown below.
# Linux / macOS example
export MCPETOOL_WORLD="/path/to/your/bedrock/world"
# Windows example (PowerShell)
$env:MCPETOOL_WORLD = "C:\Users\YourName\AppData\Local\Packages\Microsoft.MinecraftUWP_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftWorlds\your-world"Read the level.dat file
Retrieve the world's global settings as JSON. This is a quick sanity-check that the tool can find and parse your world.
mcpetool leveldat getList and access LevelDB keys
List all raw database keys, then read a specific key by its hex string representation.
# List all keys
mcpetool db list
# Get a specific key value as base64
mcpetool db get <hexkey>
# Get as JSON (NBT decoded)
mcpetool db get <hexkey> --format jsonStart the HTTP REST API server
Launch the built-in REST server on localhost:8080 to allow scripted or remote access to the world database.
mcpetool api
# Endpoints available at http://localhost:8080/api/v1/db/Write or delete world data
Replace level.dat contents or modify individual LevelDB entries. Always back up your world before writing.
# Update level.dat from a JSON file
mcpetool leveldat put < my-level-settings.json
# Write a value to a key
mcpetool db put -i data.bin <hexkey>
# Delete a key
mcpetool db delete <hexkey>MCPETool Examples
Client configuration
Configure an MCP client to run MCPETool as a server tool. Point args to the compiled binary and set the world path via environment variable.
{
"mcpServers": {
"mcpetool": {
"command": "/path/to/mcpetool",
"args": ["serve"],
"env": {
"MCPETOOL_WORLD": "/path/to/bedrock/world"
}
}
}
}Prompts to try
Use these prompts when MCPETool is connected as an MCP server for a Minecraft world assistant.
- "Read the level.dat and tell me the current game mode, difficulty, and world seed."
- "List all LevelDB keys and identify which ones correspond to player data."
- "Back up the current level.dat to a JSON file before I make changes."Troubleshooting MCPETool
Binary fails to open the world directory
Ensure Minecraft Bedrock Edition is fully closed before running MCPETool — LevelDB acquires an exclusive lock while the game is running. Set MCPETOOL_WORLD to the exact world folder path, not the parent worlds directory.
go build fails with dependency errors
Run 'go mod download' inside the cloned repository to fetch all dependencies before building. Ensure your Go version is 1.18 or later with 'go version'.
HTTP API returns garbled binary data
Append '?json' to the endpoint URL to request NBT-to-JSON conversion, for example: GET http://localhost:8080/api/v1/db/<hexkey>?json
Frequently Asked Questions about MCPETool
What is MCPETool?
MCPETool is a Model Context Protocol (MCP) server that get/put/delete cli and http api for minecraft bedrock edition world directories It connects AI assistants to external tools and data sources through a standardized interface.
How do I install MCPETool?
Follow the installation instructions on the MCPETool GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with MCPETool?
MCPETool works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is MCPETool free to use?
Yes, MCPETool is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
MCPETool Alternatives — Similar File Systems Servers
Looking for alternatives to MCPETool? Here are other popular file systems servers you can use with Claude, Cursor, and VS Code.
Electerm
★ 14.1k📻Terminal/ssh/sftp/ftp/telnet/serialport/RDP/VNC/Spice client(linux, mac, win)
Plik
★ 1.8kPlik is a temporary file upload system (Wetransfer like) in Go.
Kordoc
★ 957An MCP server that parses South Korean document formats like HWP, HWPX, and PDF into Markdown. It features specialized table reconstruction and security-hardened extraction optimized for administrative and public institution files.
macOS Automator
★ 801A Model Context Protocol server that enables execution of AppleScript and JavaScript for Automation scripts on macOS, allowing programmatic control of applications and system functions through a rich knowledge base of pre-defined scripts.
PDF Reader
★ 723Enables reading, searching, and metadata extraction from PDF files without loading the entire content into the context window. It provides efficient tools for text cleaning, page-specific extraction, and context-aware search results.
Filesystem MCP Server
★ 643Provides comprehensive filesystem operations (read, write, list, create, delete, move files and directories) through the Model Context Protocol with Streamable HTTP transport and built-in security through configurable root directory restrictions.
Browse More File Systems MCP Servers
Explore all file systems servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up MCPETool in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use MCPETool?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.