Model Context Protocol Server for Minecraft Administration
Project description
Minecraft Docker MCP
An MCP server for Minecraft-in-Docker that enables AI interactions with a running Minecraft server using itzg's docker-minecraft-server container.
- Expose server administration to AI clients like Claude Desktop, Cursor, and Zed.
- Allow models to programmatically create minecraft builds in game
LLMs have largely been trained on rcon commands, so there's a wide breadth of ability inherent in just exposing rcon to the model.
If you're already using the itzg/minecraft-server docker image, this MCP server will allow you to interact with your server via clients like Claude Desktop, Cursor, and Zed. The only requirement is that mc is the name of the container.
Prerequisites
- A running Minecraft server in a Docker container named
mc - RCON enabled and properly configured
docker run -d --name mc -p 25565:25565 -e EULA=TRUE itzg/minecraft-server
To ensure you're able to use this server, try running an rcon command to see if you get a response.
docker exec -it mc rcon "list"
If you get a response, you're all set! If you don't, please refer to the itzg/docker-minecraft-server repository for troubleshooting.
MCP Integration
This MCP server leverages itzg's docker-minecraft-server container's built-in RCON functionality to interact with the Minecraft server. The container provides the rcon command within the running container, making it an ideal target for MCP interactions.
Connecting to Claude Desktop
Clone this repository and install the rcon.py tool using the MCP CLI.
mcp install rcon.py
Project details
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file mseep_minecraft_docker_mcp-0.1.0.tar.gz.
File metadata
- Download URL: mseep_minecraft_docker_mcp-0.1.0.tar.gz
- Upload date:
- Size: 2.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
b335934108418b3485a42358d307196e9f8534e7a8f75aa2c70136c2802884b6
|
|
| MD5 |
5506f205f77d26738455f002ae603dfc
|
|
| BLAKE2b-256 |
b36d86ae5e053e5fbbed89ad45db054e3175d69c822209d211419ee13620a9da
|
File details
Details for the file mseep_minecraft_docker_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: mseep_minecraft_docker_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 2.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.1.0 CPython/3.11.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
4761b50ff6e4d246a826f52f90e8884c725a5932832169203b09c19498f76b1e
|
|
| MD5 |
e40235837166457fa4d7e56fb6c2322b
|
|
| BLAKE2b-256 |
fe053d89bd7fe8c7ca93e1fba82be648a14b21cbccd225dbd481f7cf8af79168
|