Minecraftdevelopermcp

🚀 Minecraft Developer MCP

Minecraft Developer MCP是一款輕量級的MCP橋接工具，適用於Spigot和Paper服務器。它通過HTTP協議提供控制檯訪問、文件讀寫、插件信息查詢以及日誌獲取等功能，讓外部工具無需藉助FTP或屏幕共享，就能實現服務器管理自動化。

🚀 快速開始

1. 安裝插件

從發佈頁面下載最新的JAR文件，並將其放入plugins/文件夾中。

2. 配置與安全設置

啟動一次服務器以生成配置文件。編輯plugins/MCPMinecraft/config.yml：

server:
  port: 25374 # 選擇一個開放的端口（確保主機允許該端口）
  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並調整怪物生成限制。
• 在執行命令前後查看最新的日誌條目。

✨ 主要特性

• 執行控制檯命令並返回捕獲的輸出。
• 讀取或編輯服務器目錄內的任何文本文件。
• 通過base64上傳或下載二進制文件（適用於JAR文件或圖像）。
• 列出已安裝的插件及其版本。
• 從logs/latest.log中獲取最後100行日誌。
• 列出任何目錄中的文件及其大小。

📦 工具與示例請求

📚 詳細文檔

無額外端口時的故障排除

如果主機不允許打開額外端口（例如某些免費主機提供商），可以使用如playit.gg這樣的隧道服務：

1. 在服務器上安裝playit.gg插件。
2. 創建一個指向127.0.0.1:25374（或你配置的任何本地端口）的自定義TCP隧道。
3. 在mcp.json中使用playit提供的公共地址（例如agent-tunnel.playit.gg:12345）。

從源代碼構建

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

打包後的JAR文件將位於target/目錄中。