Minemcp

🚀 MineMCP

Minecraft Paperプラグインで、Model Context Protocol (MCP)サーバーを実装し、AIエージェントがHTTPを介してMinecraft 1.21サーバーを制御および監視できるようにします。

🚀 クイックスタート

MineMCPは、Minecraft Paperのプラグインで、AIエージェントがHTTPを介してMinecraft 1.21サーバーを制御および監視できるようにするためのModel Context Protocol (MCP)サーバーを実装しています。

✨ 主な機能

ワールド操作

• pose_block - 指定された座標にブロックを設置します。
• break_block - 指定された座標のブロックを破壊します。
• fill_block - 指定された領域をブロックで埋めます。

コマンド実行

• execute_command - 任意のMinecraftコマンドを実行し、出力をキャプチャします。

ファイルシステム

• read_file - サーバーからテキストファイルを読み取ります。
• write_file - サーバーにテキストファイルを書き込みます。
• read_file_base64 - バイナリファイルをBase64形式で読み取ります。
• write_file_base64 - Base64形式からバイナリファイルを書き込みます。
• list_directory - ディレクトリの内容を一覧表示します。

サーバー情報

• list_plugins - すべてのインストールされたプラグインを取得します。
• get_logs - 最近のサーバーログを取得します。
• get_online_players - すべてのオンラインプレイヤーを一覧表示します。
• get_player - 特定のプレイヤーの詳細情報（体力、インベントリ、位置、エフェクトなど）を取得します。

📦 インストール

ビルド済みのJARをダウンロード

1. Releasesページから最新のリリースをダウンロードします。
2. MineMCP-1.0.0-all.jarをサーバーのplugins/フォルダに配置します。
3. サーバーを起動または再起動します。
4. plugins/MineMCP/config.ymlでトークンを設定します。

🔧 設定

初回起動後、plugins/MineMCP/config.ymlを編集します。

server:
  port: 3000
  token: "your-secret-token-here"  # これを安全なランダムトークンに変更してください！

重要: セキュリティ上の理由から、常にデフォルトのトークンを変更してください！

安全なトークンの生成

# Linux/macOS
openssl rand -hex 32

# または、任意のパスワード生成ツールを使用して強力なトークンを作成します。

💻 使用例

サーバーの起動

1. MineMCPがインストールされたMinecraftサーバーを起動します。
2. MCPサーバーは自動的にポート3000（設定可能）で起動します。
3. コンソールで[MineMCP] MCP server started on port 3000を確認します。

MCPクライアントで接続する

MCP拡張機能を使用したVS Codeの場合

プロジェクト内の.vscode/mcp.jsonを作成または編集します。

{
  "mcpServers": {
    "minecraft": {
      "url": "http://localhost:3000/sse?token=your-secret-token-here"
    }
  }
}

APIの使用例

コマンドを実行する

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "execute_command",
    "arguments": {
      "command": "time set day"
    }
  }
}

ブロックを設置する

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pose_block",
    "arguments": {
      "world": "world",
      "x": 100,
      "y": 64,
      "z": 200,
      "material": "DIAMOND_BLOCK"
    }
  }
}

プレイヤー情報を取得する

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_player",
    "arguments": {
      "player": "PlayerName",
      ...
    }
  }
}

🔒 セキュリティに関する考慮事項

1. トークン保護: トークンをバージョン管理システムにコミットしないでください。
2. ネットワークセキュリティ: デフォルトでは、サーバーは0.0.0.0（すべてのインターフェース）にバインドされます。
3. ファイアウォールルール: ポート3000のアクセスを信頼できるIPのみに制限してください。
4. ファイルシステムアクセス: ツールはサーバーのディレクトリ全体にアクセスできるため、注意して使用してください。

🤝 コントリビューション

コントリビューションは大歓迎です！ 以下の手順に従ってください。

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. プルリクエストを作成します。

新しいツールを追加する

1. src/main/java/me/axeno/minemcp/tools/impl/にMcpToolを拡張する新しいクラスを作成します。
2. 必要なメソッド (getSchema()とexecute()) を実装します。
3. ToolHandler.javaのコンストラクタでツールを登録します。

例:

public class MyTool extends McpTool {
    public MyTool() {
        super("my_tool", "Description of my tool");
    }

    @Override
    public ObjectNode getSchema() {
        ObjectNode schema = mapper.createObjectNode();
        schema.put("type", "object");
        // スキーマを定義...
        return schema;
    }

    @Override
    public ObjectNode execute(JsonNode args) throws Exception {
        CompletableFuture<String> future = new CompletableFuture<>();
        
        Bukkit.getScheduler().runTask(MineMCP.getInstance(), () -> {
            try {
                // ここにBukkit操作を記述
                future.complete("Success!");
            } catch (Exception e) {
                future.completeExceptionally(e);
            }
        });
        
        String result = future.get(10, TimeUnit.SECONDS);
        return createTextResult(result);
    }
}

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています - 詳細についてはLICENSEファイルを参照してください。

📞 サポート

• 問題報告: GitHub Issues

MinecraftとAIコミュニティのために愛を込めて作られました