MegaCloud MCP Server

MegaCloud MCP サーバー

MegaCloud API 用の MCP サーバーです。ミドルウェアの管理、情報の確認などができます。

機能

• ホストの確認
• ミドルウェアのライフサイクル管理（作成、起動、停止、再起動、削除、ノードの追加、ノードの削除）
• ステータスと設定の確認
• バックアップ
• ノード単位の管理

ツール

以下は、指定された形式に変換した MCP ツールの一覧です。

1. list_available_hosts

   • ミドルウェアのデプロイに使用できるホストをすべて一覧表示します。
   • 入力：なし
   • 戻り値：ホストオブジェクトのリスト。

2. list_middleware_types

   • すべてのミドルウェアタイプを一覧表示します。
   • 入力：なし
   • 戻り値：サポートされているミドルウェアタイプ識別子のリスト。

3. list_middleware_instances

   • 現在デプロイされているすべてのミドルウェアインスタンスを一覧表示します。
   • 入力：なし
   • 戻り値：ミドルウェアインスタンスオブジェクトのリスト

4. restart_middleware

   • ミドルウェアインスタンスを再起動します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：操作結果／ステータス確認

5. stop_middleware

   • ミドルウェアインスタンスを停止します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：操作結果／ステータス確認

6. start_middleware

   • ミドルウェアインスタンスを起動します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：操作結果／ステータス確認

7. delete_middleware

   • ミドルウェアインスタンスを削除します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：操作結果／削除確認

8. get_middleware_info

   • ミドルウェアインスタンスの設定やノードなど、すべての情報を取得します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：ミドルウェアインスタンスの詳細オブジェクト

9. get_middleware_status

   • ミドルウェアインスタンスのステータスを取得します。
   • 入力：
     • middleware_instance_name（string）：ミドルウェアインスタンス名
   • 戻り値：ステータスオブジェクト（例：稼働中／停止中とノードリスト）

10. backup_middleware

    • ミドルウェアインスタンスをバックアップします。
    • 入力：
      • middleware_instance_name（string）：ミドルウェアインスタンス名
    • 戻り値：バックアップタスクの詳細／確認

11. list_middleware_instance_nodes

    • ミドルウェアインスタンスのすべてのノードを一覧表示します。
    • 入力：
      • middleware_instance_name（string）：ミドルウェアインスタンス名
    • 戻り値：ノードオブジェクトの配列

12. remove_middleware_instance_nodes

    • ミドルウェアインスタンスからノードを削除します。
    • 入力：
      • name（string）：ミドルウェアインスタンス名
      • node_names（array[string]）：削除するノード名
    • 戻り値：操作結果／更新されたノードリスト

13. create_single_redis_middleware

    • 単一の Redis インスタンスを作成します。
    • 入力：
      • host_name（string）：ホスト名（必須）
      • max_memory_in_gb（integer、デフォルト 4）：最大メモリ（GB）
      • name（string | null、デフォルト null）：インスタンス名（任意）
    • 戻り値：新しく作成されたミドルウェアインスタンスオブジェクト

14. create_redis_cluster_middleware

    • Redis Cluster ミドルウェアインスタンスを作成します。
    • 入力：
      • name（string | null、デフォルト null）：クラスター名（任意）
      • max_memory_in_gb（integer、デフォルト 4）：ノードごとの最大メモリ（GB）
      • master_host_names（array[string]）：マスターホスト名（必須）
      • replica_host_names（array[string]）：レプリカホスト名（必須）
    • 戻り値：新しく作成されたクラスターインスタンスオブジェクト

15. add_redis_nodes

    • Redis ミドルウェアインスタンスにノードを追加します。
    • 入力：
      • name（string）：Redis インスタンス名（必須）
      • master_host_names（array[string] | null、デフォルト null）：新しいマスターホスト（任意）
      • replica_host_names（array[string] | null、デフォルト null）：新しいレプリカホスト（任意）
    • 戻り値：操作結果／更新されたクラスターのトポロジー

セットアップ

認証トークンを取得する

MegaCloud コンソールにログインし、API 呼び出しの読み込み中にブラウザーの Network タブを開いて、Authorization: Bearer <token> ヘッダーの値を抽出します。

インストール

リポジトリをクローンします：

git clone https://github.com/megaease/megacloud-mcp.git

次に、以下を実行します

pip install "mcp[cli]"

mcp コマンドをすべてのユーザー向けにグローバルインストールしてください。

VS Code との統合

Cline

VS Code 拡張機能の Cline をインストールします。

以下の設定で MegaCloud MCP サーバーを設定します：

{
  "mcpServers": {
    "megacloud-mcp": {
      "type": "stdio",
      "command": "mcp",
      "args": [
        "run",
        "<your-repo-dir>/megacloud-mcp/megacloud_mcp/__main__.py"
      ],
      "env": {
        "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
      }
    }
  }
}

GitHub Copilot

{
    "mcp": {
        "servers": {
            "test-megacloud-mcp": {
                "type": "stdio",
                "command": "mcp",
                "args": [
                    "run",
                    "<your-repo-dir>/megacloud-mcp/megacloud_mcp/__main__.py"
                ],
                "env": {
                    "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
                }
            }
        }
    }
}

Docker で実行

イメージをビルドします：

docker build -t megaease/megacloud-mcp . 

設定：

{
    "megacloud-mcp": {
        "type": "stdio",
        "command": "docker",
        "args": [
            "run",
            "-i", 
            "--rm",
            "-e",
            "MEGACLOUD_AUTHTOKEN",
            "megaease/megacloud-mcp"
        ],
        "env": {
            "MEGACLOUD_AUTHTOKEN": "<your-auth-token>"
        }
    }
}