Skip to main content

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

mseep_minecraft_docker_mcp-0.1.0.tar.gz (2.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mseep_minecraft_docker_mcp-0.1.0-py3-none-any.whl (2.0 kB view details)

Uploaded Python 3

File details

Details for the file mseep_minecraft_docker_mcp-0.1.0.tar.gz.

File metadata

File hashes

Hashes for mseep_minecraft_docker_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 b335934108418b3485a42358d307196e9f8534e7a8f75aa2c70136c2802884b6
MD5 5506f205f77d26738455f002ae603dfc
BLAKE2b-256 b36d86ae5e053e5fbbed89ad45db054e3175d69c822209d211419ee13620a9da

See more details on using hashes here.

File details

Details for the file mseep_minecraft_docker_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for mseep_minecraft_docker_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 4761b50ff6e4d246a826f52f90e8884c725a5932832169203b09c19498f76b1e
MD5 e40235837166457fa4d7e56fb6c2322b
BLAKE2b-256 fe053d89bd7fe8c7ca93e1fba82be648a14b21cbccd225dbd481f7cf8af79168

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page