Minecraftdevelopermcp

🚀 Minecraft Developer MCP

このプロジェクトは、SpigotとPaperサーバー用の軽量MCPブリッジです。HTTP経由でコンソールアクセス、ファイルの読み書き、プラグイン情報、ログ取得などを提供し、FTPや画面共有を使用せずに外部ツールでサーバー管理を自動化できるようにします。

✨ 主な機能

• コンソールコマンドを実行し、キャプチャした出力を返します。
• サーバーディレクトリ内の任意のテキストファイルを読み取ったり編集したりします。
• base64を介してバイナリファイルをアップロードまたはダウンロードします（JARや画像に最適）。
• インストールされているプラグインとそのバージョンを一覧表示します。
• logs/latest.log から最後の100行を取得します。
• 任意のディレクトリ内のファイルをサイズとともに一覧表示します。

📚 ドキュメント

ツールとリクエスト例

🚀 クイックスタート

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 を読み取り、モンスターのスポーン制限を調整します。
• コマンドを実行する前後の最新のログエントリを確認します。

トラブルシューティング：追加ポートが使用できない場合

ホストが追加ポートの開放を許可していない場合（一部の無料プロバイダーなど）、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/ ディレクトリにあります。