Back to MCP directory
publicPublicdnsLocal runtime

Minecraft RCON

一个基于Docker的Minecraft服务器管理工具,通过RCON实现AI与Minecraft服务器的交互

article

README

🚀 Minecraft Docker MCP 服务器

本项目是一个用于 Minecraft-in-Docker 的 MCP 服务器,它借助 itzg 的 docker-minecraft-server 容器,实现了 AI 与运行中的 Minecraft 服务器的交互。AI 模型可通过 RCON 命令与游戏互动,还能创建游戏内建筑。

✨ 主要特性

  • 将服务器管理权限开放给 Claude Desktop、Cursor 和 Zed 等 AI 客户端。
  • 支持模型以程序化方式在游戏内生成 Minecraft 建筑。

由于大语言模型(LLM)通常基于 RCON 命令进行训练,因此只需将 RCON 暴露给模型,就能发挥其强大能力。若你正在使用 itzg/minecraft-server 的 Docker 镜像,此 MCP 服务器可让你通过 Claude Desktop、Cursor 和 Zed 等 AI 客户端与服务器交互,前提是容器名为 mc

🚀 快速开始

📦 安装指南

先决条件

  • 运行中的 Minecraft 服务器,Docker 容器名称为 mc
  • 已启用并正确配置 RCON

你可以使用以下命令启动 Docker 容器:

docker run -d --name mc -p 25565:25565 -e EULA=TRUE itzg/minecraft-server

为确保服务器可用,你可以尝试运行一个 RCON 命令来检查是否能获得响应:

docker exec -it mc rcon "list"

若得到响应,则表示一切正常;若未得到响应,请参考 itzg/docker-minecraft-server 仓库进行故障排除。

💻 使用示例

MCP 集成

此 MCP 服务器利用 itzg 的 docker-minecraft-server 容器内置的 RCON 功能与 Minecraft 服务器交互。容器在运行时环境中提供了 rcon 命令,非常适合 MCP 交互。

连接到 Claude Desktop

克隆此仓库并使用 MCP CLI 安装 rcon.py 工具:

mcp install rcon.py
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client