Get the FREE Ultimate OpenClaw Setup Guide →

MCPE.AlphaServer

A Minecraft Pocket Edition server for 0.8.1 written in C#

Installation
Run this command in your terminal to add the MCP server to Claude Code.
Run in terminal:
Command
claude mcp add --transport stdio atipls-mcpe.alphaserver python server.py \
  --env DEBUG="true" \
  --env MCPE_ALPHA="1"

How to use

MCPE.AlphaServer is a Minecraft Pocket Edition server focused on handling player connections and movements for the Alpha v0.8.1 era. This MCP server is an early-stage implementation intended as a documented alternative to PocketMine, with the current capabilities limited to basic client connections and movement processing. To use it, start the server using the command configuration above and then connect a Minecraft Pocket Edition client compatible with Alpha v0.8.1. The server manages the player map and basic networking to validate logins and track movements as clients interact with the world.

Once running, you can monitor the console for connection events and movement updates. Use the provided environment flags to enable debugging or feature toggles as needed during development or testing, and adjust the entry point (server.py) if your deployment uses a different script name or path.

How to install

Prerequisites:

  • Python 3.8 or newer installed on your system
  • Access to the MCPE.AlphaServer repository files (clone or download)

Steps:

  1. Clone the repository: git clone https://github.com/organization/MCPE.AlphaServer.git
  2. Navigate to the project directory: cd MCPE.AlphaServer
  3. If a requirements.txt exists, install dependencies: python -m pip install -r requirements.txt
  4. Ensure the entry script (server.py) exists or update the mcp_config to point to the correct entry point
  5. Start the server using the configured command: python server.py
  6. Check the console output to verify the server is listening for MCPE clients and handling connections

Additional notes

This project is an early implementation focused on connection handling and movement. Potential issues include client version mismatches with Alpha v0.8.1, missing dependencies, or firewall/port accessibility problems. Ensure the server port is open and reachable from MCPE clients. If you alter the entry script name or location, update mcp_config accordingly. Use the DEBUG environment variable to surface verbose logs during troubleshooting.

Related MCP Servers

Sponsor this space

Reach thousands of developers