AI导哈

Minecraft服务器管理桥接工具

一个轻量级的MCP桥接工具，为Spigot和Paper服务器提供HTTP接口以实现远程服务器管理，包括执行命令、文件读写、插件管理和日志获取等功能。

  • by center2055
  • Java
  • 本地部署
  • 5 星标
  • 更新于
在 GitHub 查看 center2055/MinecraftDeveloperMCP

使用说明

Minecraft开发者MCP

Spigot和Paper服务器的轻量级MCP网桥。它通过HTTP公开控制台访问、文件读/写、插件信息和日志检索，因此外部工具可以在没有FTP或屏幕共享的情况下自动化服务器管理。

它能做什么

  • 运行控制台命令并返回捕获的输出。
  • 在服务器目录中的任何位置读取或编辑文本文件。
  • 通过base64上传或下载二进制文件（非常适合JAR或图像）。
  • 列出已安装的插件及其版本。
  • 从以下位置抓取最后100行 logs/latest.log.
  • 列出任何目录中具有大小的文件。

工具和示例请求

工具 描述 请求示例
execute_command 运行任何带有输出捕获的控制台命令。 Give 'Notch' a diamond sword named 'Excalibur'.
read_file 读取服务器目录中的任何文本文件（配置、日志、数据） Read plugins/Essentials/config.yml and show the chat format.
write_file 就地创建或编辑文件。 Create plugins/Skript/scripts/welcome.sk that greets players on join.
list_plugins 列出已安装的插件和版本。 Check if WorldGuard is enabled and up to date.
get_logs 获取最后100行 latest.log. Grab recent logs to see why the server lagged.
write_file_base64 通过base64上传二进制文件。 Upload SuperSword.jar to plugins/ and confirm size.
read_file_base64 下载base64格式的二进制文件。 Return world/icon.png as base64.
list_directory 按大小列出文件夹中的文件。 List everything in world/region.

快速开始

1.安装插件

从下载最新的JAR文件 发布页面 然后把它放进你的 plugins/ 文件夹。

2.配置和保护

启动服务器一次以生成配置。编辑 plugins/MCPMinecraft/config.yml:

server:
  port: 25374 # Choose an open port (ensure your host allows it)
  token: "CHANGE-THIS-TO-A-SECURE-RANDOM-TOKEN"

安全警告：任何拥有此令牌的人都可以访问控制台。让它长而随机。

3.连接MCP客户端（示例配置）

把这个放在你的 mcp.json （通常在 ~/.cursor/mcp.json):

{
  "mcpServers": {
    "minecraft": {
      "url": "http://YOUR-SERVER-IP:25374/sse?token=YOUR-SECURE-TOKEN",
      "transport": "sse"
    }
  }
}

对于脚本编写或自动化，您还可以使用同步 /api 端点：

curl -X POST "http://YOUR-SERVER-IP:25374/api?token=YOUR-TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"list_plugins","arguments":{}}}'

4.使用它

  • 备份 whitelist.json，然后添加 jeb_.
  • 阅读 bukkit.yml 并调整怪物产卵限制。
  • 跟踪运行命令前后的最新日志条目。

故障排除：没有额外端口？

如果您的主机不允许打开额外的端口（例如，一些免费提供商），请使用playit.gg等隧道：

  1. 安装 playit.gg插件 在您的服务器上。
  2. 创建指向的自定义TCP隧道 127.0.0.1:25374 （或您配置的任何本地端口）。
  3. 使用playit中的公共地址（例如 agent-tunnel.playit.gg:12345)在你的 mcp.json.

从源代码构建

git clone https://github.com/center2055/MinecraftDeveloperMCP.git
cd MinecraftDeveloperMCP
mvn clean package

阴影JAR将位于 target/.

相关 MCP