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等隧道：
- 安装 playit.gg插件 在您的服务器上。
- 创建指向的自定义TCP隧道
127.0.0.1:25374（或您配置的任何本地端口）。 - 使用playit中的公共地址（例如
agent-tunnel.playit.gg:12345)在你的mcp.json.
______________________________________________________________________
从源代码构建
git clone https://github.com/center2055/MinecraftDeveloperMCP.git
cd MinecraftDeveloperMCP
mvn clean package阴影JAR将位于 target/.