返回 MCP 目录
public公开dns本地运行

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

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端