Assisted Service MCP Server

Assisted Service MCP Server

OpenShift assisted installer API とやり取りするための MCP サーバーです。

クラスターの障害を診断し、解決方法を確認できます。

お試しください：

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

git clone [email protected]:carbonin/assisted-service-mcp.git

2. https://cloud.redhat.com/openshift/token から OpenShift API トークンを取得します。

3. 使用するトランスポートに応じて、サーバーの起動方法と設定方法が異なります。

STDIO の場合：

たとえば VSCode では：

   "mcp": {
        "servers": {
            "AssistedService": {
                "command": "uv",
                "args": [
                    "--directory",
                    "/path/to/assisted-service-mcp",
                    "run",
                    "mcp",
                    "run",
                    "/path/to/assisted-service-mcp/server.py"
                ],
                "env": {
                    "OFFLINE_TOKEN": <your token>
                }
            }
        }
    }

SSE の場合（推奨）：

ターミナルでサーバーを起動します：

OFFLINE_TOKEN=<your token> uv run server.py

クライアントでサーバーを設定します：

    "assisted-sse": {
      "transport": "sse",
      "url": "http://localhost:8000/sse"
    }

リクエストヘッダーによるオフライントークンの指定

OFFLINE_TOKEN 環境変数を設定しない場合は、リクエストヘッダーでトークンを指定できます。 MCP クライアントを設定する際に、OCM-Offline-Token ヘッダーを追加します：

    "assisted-sse": {
      "transport": "sse",
      "url": "http://localhost:8000/sse",
      "headers": {
        "OCM-Offline-Token": "<your token>"
      }
    }

4. クラスターについて質問します：

利用可能なツール

MCP サーバーには、OpenShift Assisted Installer とやり取りするための次のツールが用意されています：

クラスター管理

• list_clusters - 現在のユーザーの assisted installer クラスターをすべて一覧表示します。最小限のクラスター情報を返します。

• cluster_info - 指定した ID の assisted installer クラスターに関する詳細情報を取得します

  • cluster_id：クラスター ID（文字列、必須）

• create_cluster - 新しい assisted installer クラスターと infraenv を作成します。single_node は、シングルノードクラスターを作成する場合、または高可用性が不要な場合にのみ true に設定してください。クラスター ID と infraenv ID を JSON で返します。

  • name：クラスター名（文字列、必須）
  • version：OpenShift のバージョン（文字列、必須）
  • base_domain：クラスターのベースドメイン（文字列、必須）
  • single_node：シングルノードクラスターを作成するかどうか（ブール値、必須）

• install_cluster - 指定した ID の assisted installer クラスターのインストールを開始します

  • cluster_id：クラスター ID（文字列、必須）

• set_cluster_vips - クラスターの API および ingress の仮想 IP アドレス（VIP）を設定します

  • cluster_id：クラスター ID（文字列、必須）
  • api_vip：API の仮想 IP アドレス（文字列、必須）
  • ingress_vip：Ingress の仮想 IP アドレス（文字列、必須）

イベントとモニタリング

• cluster_events - 指定した ID のクラスターに関連するイベントを取得します

  • cluster_id：クラスター ID（文字列、必須）

• host_events - クラスター内の特定のホストに関連するイベントを取得します

  • cluster_id：クラスター ID（文字列、必須）
  • host_id：ホスト ID（文字列、必須）

インフラストラクチャ環境

• infraenv_info - 指定した ID の assisted installer infra env に関する詳細情報を取得します。ISO のダウンロード URL や infra env のメタデータなどが含まれます。
  • infraenv_id：インフラストラクチャ環境 ID（文字列、必須）

ホスト管理

• set_host_role - ホストのロールを指定したものに更新します。ロールの選択肢は「auto-assign」、「master」、「arbiter」、「worker」です。
  • host_id：ホスト ID（文字列、必須）
  • infraenv_id：インフラストラクチャ環境 ID（文字列、必須）
  • role：ホストのロール（文字列、必須）

OpenShift のバージョンとオペレーター

• list_versions - assisted installer によるインストールで利用可能な OpenShift のバージョンを一覧表示します

• list_operator_bundles - インストール中にクラスターへ追加できるオプションのオペレーターバンドルを一覧表示します

• add_operator_bundle_to_cluster - 指定したクラスターにオペレーターバンドルをインストールするようリクエストします

  • cluster_id：クラスター ID（文字列、必須）
  • bundle_name：オペレーターバンドル名（文字列、必須）

使用例

• クラスターをすべて一覧表示：「自分のクラスターをすべて表示して」
• クラスターの詳細を取得：「クラスター abc123 の詳細情報を教えて」
• クラスターを作成：「OpenShift 4.14 とベースドメイン「example.com」で「my-cluster」という新しいクラスターを作成して」
• クラスターのイベントを確認：「クラスター abc123 でどんなイベントが発生した？」
• クラスターをインストール：「クラスター abc123 のインストールを開始して」