Bedrock

You can run and manage Bedrock Server Manager through a dedicated MCP server, giving you natural language access to common tasks like starting, stopping, updating, and backing up your Bedrock servers. This guide walks you through installing, configuring, and using the MCP server so you can control your Minecraft Bedrock Edition fleet with simple commands.

How to use

You interact with the MCP server through an MCP client to perform server, player, world, backup, and advanced administrative tasks using natural language. Start by ensuring the MCP server is running, then issue commands like starting a server, listing servers and statuses, backing up worlds, or exporting a world. The MCP server translates your natural language requests into concrete actions on Bedrock Server Manager, returning results and status updates that help you stay informed.

How to install

Prerequisites: Python 3.8 or higher. A running Bedrock Server Manager instance. Valid credentials for Bedrock Server Manager.

# 1. Clone the MCP project
git clone <repository-url>
cd BedrockMCP

# 2. Create a virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# 3. Install dependencies
pip install -r requirements.txt

# 4. Configure environment variables
# Create a .env file in the project root with required values

Environment configuration example for the MCP server to talk to Bedrock Server Manager. Adjust values to match your setup.

# .env
BEDROCK_API_BASE=http://localhost:11325
BEDROCK_SERVER_MANAGER_USERNAME=your_username
BEDROCK_SERVER_MANAGER_PASSWORD=your_password
BEDROCK_DEBUG=false

Additional setup and running

Standalone mode lets you run the MCP server locally for testing and operation. Start the server with Python and, if desired, enable debug output to see detailed API responses.

python bedrock_mcp_server.py

python bedrock_mcp_server.py --debug

With Claude Desktop integration

If you want to drive the MCP server from Claude Desktop, add an MCP server configuration that points to the start script. This enables Claude to initiate and control MCP-powered actions through natural language.

{
  "mcpServers": {
    "bedrock-server-manager": {
      "command": "/path/to/your/BedrockMCP/start_bedrock_mcp.sh",
      "args": []
    }
  }
}

Troubleshooting

Connection issues typically involve verifying that Bedrock Server Manager is reachable, credentials are correct, and the API base URL is accessible. If you encounter errors, enable debug mode to get more detailed responses and inspect the logs for authentication or network problems.

# Check API health
curl http://localhost:11325/api/health

# Run with debug to get verbose logs
python bedrock_mcp_server.py --debug

Notes and security

Keep credentials secure. Do not expose API keys or credentials in shared configurations. Use environment-based secrets where possible and restrict access to the Bedrock Server Manager API to trusted networks.

Appendix

This MCP server supports a broad set of operations including server lifecycle, player and world management, backups, add-ons, plugins, scheduled tasks, and system monitoring. Extend usage by combining natural language commands to perform complex tasks across multiple servers and worlds.