mcpField
R
Red Hat Lightspeed MCP

Red Hat Lightspeed MCP

ローカル
github.com/RedHatInsightsクラウド・インフラ251 日前に更新

Red Hat Lightspeed MCP について

Red Hat Lightspeed MCP は、MCP クライアントと LLM エージェントを Red Hat Lightspeed サービスに接続するセルフホスト型サーバーです。既定では読み取り専用で、書き込みツールは RBAC 権限に基づいて有効化できます。

主な機能

  1. 01複数の Lightspeed サービスに接続
  2. 02既定で読み取り専用
  3. 03書き込みツールの任意有効化
  4. 04自然言語での問い合わせ
  5. 05RBAC による操作制限

活用シーン

  1. 01Advisor の提案やインベントリーを確認
  2. 02脆弱性や修復情報を確認
  3. 03イメージビルダーの計画を扱う
  4. 04自然言語で Lightspeed サービスを検索

MCP 対応

MCP サーバーとして、Advisor、Inventory、Vulnerability、Image Builder など Red Hat Lightspeed サービスの操作を公開します。ツールは既定で読み取り専用で、書き込み操作もアカウント権限の範囲内です。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"redhatinsights-insights": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"LIGHTSPEED_CLIENT_ID",
"-e",
"LIGHTSPEED_CLIENT_SECRET",
"ghcr.io/redhatinsights/red-hat-lightspeed-mcp"
],
"env": {
"LIGHTSPEED_CLIENT_ID": "<LIGHTSPEED_CLIENT_ID>",
"LIGHTSPEED_CLIENT_SECRET": "<LIGHTSPEED_CLIENT_SECRET>"
}
}
}
}
起動コマンドdocker run -i --rm -e LIGHTSPEED_CLIENT_ID -e LIGHTSPEED_CLIENT_SECRET ghcr.io/redhatinsights/red-hat-lightspeed-mcp
設定が必要な環境変数
LIGHTSPEED_CLIENT_IDシークレットRed Hat Lightspeed Client ID for authentication
LIGHTSPEED_CLIENT_SECRETシークレットRed Hat Lightspeed Client Secret for authentication

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
ocighcr.io/redhatinsights/red-hat-lightspeed-mcp

ツール

ツール一覧はまだ取得されていません

ローカルサーバーのツールはマシン上で起動して初めて取得できます。メンテナーはまだツール一覧を提供していません。

詳細

Red Hat Lightspeed MCP

(以前は Insights MCP として知られていました)

Red Hat Lightspeed Model Context Protocol(MCP)サーバーは、Claude Desktop などの MCP 互換ツールを含む、LLM ベースのエージェントを Red Hat Lightspeed サービスに接続する、軽量でセルフホスト可能なソリューションです。

特長

  • 読み取り専用操作をサポートします:サーバーはデフォルトで読み取り専用モードで動作します。書き込みツール(ブループリントの作成、コンポーズの実行など)を有効にするには、--all-tools を使用します。RBAC 権限でアクセスを制限することもできます。
  • 自然言語のプロンプトを提供します:自然言語を使って Red Hat Lightspeed サービスにクエリを実行できます。

サポート対象の Lightspeed サービス

セットアップと使用方法

認証

注:認証が必要なのは、Red Hat Lightspeed API にアクセスする場合のみです。MCP サーバー自体に認証は必要ありません。

認証方法は 2 つあります。

  1. サービスアカウント(client_id + client_secret)— サービスアカウントを作成し、環境変数または HTTP ヘッダーで認証情報を指定します。
  2. JWT ベアラートークン — 既存の JWT トークンを Authorization: Bearer <token> HTTP ヘッダーで指定します(SSE/HTTP トランスポートのみ)。
サービスアカウントのセットアップ
  1. https://console.redhat.com にアクセスし、Settings(⚙️ Gear Icon)→ "Service Accounts" をクリックします。
  2. サービスアカウントを作成し、後で使用する Client ID と Client secret を控えておきます。
    以下の統合手順では、それぞれ LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET として記載しています。
ツールセットごとの必須権限

ツールセットごとに、サービスアカウントに特定のロールが必要です。

  • Advisor ツール:RHEL Advisor viewer、Inventory Hosts viewer
  • OCP Advisor ツール:OCP Advisor administrator
  • Inventory ツール:Inventory Hosts viewer、Workspace viewer
  • Vulnerability ツール:Vulnerability viewer、Inventory Hosts viewer
  • Remediation ツール:Remediations user
  • Image Builder ツール:Repositories viewer
  • RHSM ツール:RHC user
  • Content Sources ツール:Repositories viewer
  • Planning ツール:Inventory Hosts viewer

これらの名前は、Hybrid Cloud Console のユーザーアクセス画面に表示される名称です。ロールの詳細 URL にはテナント固有の識別子が含まれているため、アカウント間でコピーしないでください。統合された RHEL viewer ロールは、上記の複数の viewer ロールの代わりに使用できます。

サービスアカウントへの権限の付与

デフォルトでは、サービスアカウントにはアクセス権がありません。組織の管理者が権限を割り当てる必要があります。MCP サーバーは、権限が付与されているタスクのみを実行できます。たとえば、読み取り専用の操作を許可し、書き込み操作を拒否したい場合、これは権限システムを通じて実現できます。

詳細な手順については、こちらのビデオチュートリアルをご覧ください: サービスアカウントの権限設定

  1. 組織の管理者としてログインします(ユーザーアクセス管理者ロールを使用)

  2. ユーザーアクセス設定に移動: 設定(⚙️ 歯車アイコン)→「ユーザーアクセス」→「グループ」をクリックします

  3. 権限を割り当てます(いずれかのオプションを選択):

    オプション A - 新しいグループを作成:

    • 新しいグループを作成します(例: mcp-service-accounts)
    • 必要なロールを追加します(例: RHEL Advisor viewer、Inventory Hosts viewer など)
    • このグループにサービスアカウントを追加します

    オプション B - 既存のグループを使用:

    • 必要なロールを持つ既存のグループを開きます
    • 「サービスアカウント」タブに移動します
    • グループにサービスアカウントを追加します

サービスアカウントは、割り当てられたグループのすべてのロールを継承します。

⚠️ セキュリティに関する注意事項 ⚠️

この MCP サーバーをローカルで(podman または docker で)起動する場合、コンテナがインターネットに公開されていないことを確認してください。このシナリオでは、MCP クライアント(例: VSCode、Cursor など)が LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET を取得できる可能性がありますが、LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET を使用してもおそらく問題ありません。

別のマシンからこの MCP サーバーに接続するデプロイメントの場合、LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET(または JWT Bearer トークン)が MCP サーバーに転送されること、およびリモート MCP サーバーがそれらを漏洩しないことを信頼していることを考慮する必要があります。

どちらの場合も、不安がある場合は、MCP サーバーの使用が完了した後に、アカウントから LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET を無効化/削除してください。

セキュリティとインシデント対応(緊急失効)

安全な AI 運用とセキュリティ標準への準拠を確保するため、運用者は異常な AI の動作、予期しないデータ露出、またはトークン侵害の疑いが生じた場合に、接続された LLM の Red Hat Lightspeed へのアクセスを迅速に切断できる必要があります。

緊急「キルスイッチ」手順:

ツールセットへの AI アクセスを直ちに失効させる必要がある場合は、次の手順を実行します:

  1. サーバーを終了: MCP コンテナまたはローカルプロセスを直ちに停止します(例: podman ps を実行してコンテナを特定し、次に podman stop <container_id> を実行します)。
  2. 認証情報を失効: MCP サーバーが Red Hat サービスで認証するために使用する Red Hat Client ID を無効化します。「サービスアカウント」ページに移動し、認証情報を Delete または Reset します。

さらに、ローカルの LLM クライアントの設定から MCP サーバーのエントリ(例: クライアントの mcp.json 内の lightspeed-mcp)を削除して、クライアントがサーバーの再起動や再接続を試みないようにすることもできます。

認証情報の侵害やデータ露出が疑われる場合は、適用される法律(例: GDPR)に基づく侵害通知の義務を評価してください。ログ記録、デバッグモード、コンプライアンスの詳細については、HACKING.md - ログ記録とコンプライアンスを参照してください。

技術情報

ツールセット

MCP サーバーで利用可能なツールセットについては、toolsets.mdを参照してください。

連携

前提条件

podman がインストールされていることを確認してください。
(Docker でも問題ありませんが、以下のコマンドはそれに合わせて適宜変更する必要があります)

Fedora/RHEL/CentOS では sudo dnf install podman でインストールできます。 macOS では Podman Desktop または Podman の手順に従ってください。

⚠️ 注意 macOS で Podman を使用する場合、podman へのパスを明示的に設定する必要があることがあります。 たとえば podman をフルパスに置き換えます。次のようなものになります

  • /usr/local/bin/podman
  • /opt/homebrew/bin/podman
  • …

パスはターミナルで which podman を実行すると確認できます。

Goose Desktop

まず前提条件セクションを確認してください。

オプション 1: ワンクリックインストール (最も簡単)

Install in Goose

このバッジは HTTPS リダイレクト (goose-docs.ai/extension?...) を使用し、Goose Desktop の拡張機能インストールフローを開きます。

(注: これは quay.io コンテナイメージとコマンドとして docker を使用します — Goose のディープリンクは podman ではなく docker のみをサポートしています。Podman を使用する場合は以下の手動インストールを使用してください。)

クリック後、Goose は LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET の入力を求め、その後拡張機能をインストールします。使用するには新しいチャットセッションを開始してください。

オプション 2: 手動 STDIO インストール
  1. 左上のボタンをクリックしてサイドバーを開きます。
  2. サイドバーの Extensions ボタンをクリックします。
  3. Extensions の下にある Add custom extension をクリックします。
  4. Add custom extension モーダルで以下を入力します:
    • Type: Standard IO
    • ID: red-hat-lightspeed-mcp
    • Name: Red Hat Lightspeed MCP
    • Description: Red Hat Lightspeed MCP server integration
    • Command: podman run --env LIGHTSPEED_CLIENT_ID --env LIGHTSPEED_CLIENT_SECRET --interactive --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest
    • Environment variables: それぞれについて Add をクリックします:
      • LIGHTSPEED_CLIENT_ID — Red Hat Lightspeed Client ID
      • LIGHTSPEED_CLIENT_SECRET — Red Hat Lightspeed Client Secret
    • Timeout: 必要でなければデフォルト (300s) のままにします
  5. Add をクリックします。

Docker ユーザーはコマンド内の podman を docker に置き換えられます。macOS で Goose が podman を見つけられない場合は、which podman で得られるフルパスを使用してください (前提条件を参照)。

Cursor

まず前提条件セクションを確認してください。

オプション 1: ワンクリックインストール (最も簡単)

⚠️ Ctrl/Cmd-クリックで新しいタブで開いてください。
そうしないと、インストール後にタブが閉じられ、ドキュメントを確認できなくなります。
Install with Podman in Cursor
(注: これは quay.io コンテナイメージを使用します)

オプション 2: 手動による STDIO インストール

Cursor は inputs をサポートしていないようであるため、認証情報を設定ファイルに追加する必要があります。 統合を開始するには、~/.cursor/mcp.json というファイルを次の内容で作成します。

{
  "mcpServers": {
    "lightspeed-mcp": {
        "type": "stdio",
        "command": "podman",
        "args": [
            "run",
            "--env",
            "LIGHTSPEED_CLIENT_ID",
            "--env",
            "LIGHTSPEED_CLIENT_SECRET",
            "--interactive",
            "--rm",
            "ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest"
        ],
        "env": {
            "LIGHTSPEED_CLIENT_ID": "",
            "LIGHTSPEED_CLIENT_SECRET": ""
        }
    }
  }
}

Some tools have naming issues and may be filtered out. というエラーが表示される場合は、既知の問題を参照してください。

オプション 3: 手動による Streamable HTTP インストール (上級者向け)

サーバーを起動します:

podman run -p 127.0.0.1:8000:8000 --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest http --host 0.0.0.0

次に、サービスアカウントの認証情報を使用して統合します:

{
    "mcpServers": {
        "lightspeed-mcp": {
            "type": "http",
            "url": "http://localhost:8000/mcp",
            "headers": {
                "lightspeed-client-id": "",
                "lightspeed-client-secret": ""
            }
        }
    }
}

または、JWT ベアラートークンを使用して統合します:

{
    "mcpServers": {
        "lightspeed-mcp": {
            "type": "http",
            "url": "http://localhost:8000/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_JWT_TOKEN>"
            }
        }
    }
}
VSCode

まず前提条件セクションを確認してください。

オプション 1: ワンクリックインストール (最も簡単)

Install with Podman in VS Code
(注: これは quay.io コンテナイメージを使用します)

オプション 2: 手動による STDIO インストール

プロジェクトで使用するには、.vscode/mcp.json というファイルを次の内容で作成します。

{
    "inputs": [
        {
            "id": "lightspeed_client_id",
            "type": "promptString",
            "description": "Enter the Red Hat Lightspeed Client ID",
            "default": "",
            "password": true
        },
        {
            "id": "lightspeed_client_secret",
            "type": "promptString",
            "description": "Enter the Red Hat Lightspeed Client Secret",
            "default": "",
            "password": true
        }
    ],
    "servers": {
        "lightspeed-mcp": {
            "type": "stdio",
            "command": "podman",
            "args": [
                "run",
                "--env",
                "LIGHTSPEED_CLIENT_ID",
                "--env",
                "LIGHTSPEED_CLIENT_SECRET",
                "--interactive",
                "--rm",
                "ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest"
            ],
            "env": {
                "LIGHTSPEED_CLIENT_ID": "${input:lightspeed_client_id}",
                "LIGHTSPEED_CLIENT_SECRET": "${input:lightspeed_client_secret}"
            }
        }
    }
}
Gemini CLI

まず前提条件セクションを確認してください。

オプション 1: 手動による STDIO インストール

統合を開始するには、~/.gemini/settings.json というファイルを次のコマンドで作成します:

{
    ...
    "mcpServers": {
        "lightspeed-mcp": {
            "type": "stdio",
            "command": "podman",
            "args": [
                "run",
                "--env",
                "LIGHTSPEED_CLIENT_ID=<YOUR_CLIENT_ID>",
                "--env",
                "LIGHTSPEED_CLIENT_SECRET=<YOUR_CLIENT_SECRET>",
                "--interactive",
                "--rm",
                "ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest"
            ]
        }
    }
}
オプション 2: 手動による Streamable HTTP インストール (上級者向け)

サーバーを起動します:

podman run -p 127.0.0.1:8000:8000 --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest http --host 0.0.0.0

次に、サービスアカウントの認証情報を使用して統合します:

{
    ...
    "mcpServers": {
        "lightspeed-mcp": {
            "httpUrl": "http://localhost:8000/mcp",
            "headers": {
                "lightspeed-client-id": "<YOUR_CLIENT_ID>",
                "lightspeed-client-secret": "<YOUR_CLIENT_SECRET>"
            }
        }
    }
}

または、JWT ベアラートークンを使用して統合します:

{
    ...
    "mcpServers": {
        "lightspeed-mcp": {
            "httpUrl": "http://localhost:8000/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_JWT_TOKEN>"
            }
        }
    }
}
Claude Desktop

まず前提条件セクションを確認してください。

Claude Desktop 向けには、プロジェクトのリリースセクションに拡張機能ファイルがあります。

red-hat-lightspeed-mcp*.mcpb ファイル (またはレガシー形式の場合は red-hat-lightspeed-mcp*.dxt) をダウンロードし、Claude Desktop で次の手順により追加するだけです:

Settings -> Extensions -> Advanced Extensions Settings -> Install Extension…

VSCode での CLine

まず前提条件セクションを確認してください。

まず最初に、sse 引数を指定して SSE サーバーを起動します:

export LIGHTSPEED_CLIENT_ID=<YOUR_CLIENT_ID>
export LIGHTSPEED_CLIENT_SECRET=<YOUR_CLIENT_SECRET>
podman run --env LIGHTSPEED_CLIENT_ID --env LIGHTSPEED_CLIENT_SECRET -p 127.0.0.1:9000:9000 --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest sse --host 0.0.0.0

CLine -> Manage MCP Servers インターフェースで、新しいサーバー名と URL (http://localhost:9000/sse) を追加します。次の設定が作成されます:

{
  "mcpServers": {
    "lightspeed-mcp": {
      "disabled": false,
      "type": "sse",
      "url": "http://localhost:9000/sse"
    }
  }
}

CLine はまだ HTTP トランスポートをサポートしていないため、type が sse であることを確認してください。

汎用 STDIO

まず前提条件セクションを確認してください。

STDIO を介して他のツールに汎用的に統合するには、環境変数 LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET を設定し、podman を使用した統合には次のコマンドを使用します:

export LIGHTSPEED_CLIENT_ID=<YOUR_CLIENT_ID>
export LIGHTSPEED_CLIENT_SECRET=<YOUR_CLIENT_SECRET>
podman run --env LIGHTSPEED_CLIENT_ID --env LIGHTSPEED_CLIENT_SECRET --interactive --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest

標準入力を通じて公開されるのは MCP API であり、チャットインターフェースではありません。 red-hat-lightspeed-mcp サーバーに接続して実際に使用するには、「エージェント機能」を備えた MCP クライアントが必要です。

Claude Code

まず、前提条件のセクションを確認してください。

Claude Code の実行時にはホスト環境を利用できないため、podman コマンドに少し変更が必要です。代わりに認証情報を設定にコピーする必要があります。これは、環境変数 LIGHTSPEED_CLIENT_ID と LIGHTSPEED_CLIENT_SECRET を設定した後、次のコマンドで実行できます。

export LIGHTSPEED_CLIENT_ID=<YOUR_CLIENT_ID>
export LIGHTSPEED_CLIENT_SECRET=<YOUR_CLIENT_SECRET>
claude mcp add red-hat-lightspeed-mcp -- podman run --env LIGHTSPEED_CLIENT_ID=$LIGHTSPEED_CLIENT_ID --env LIGHTSPEED_CLIENT_SECRET=$LIGHTSPEED_CLIENT_SECRET --interactive --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest

または、コマンド内で変数を直接設定します。

claude mcp add red-hat-lightspeed-mcp -- podman run --env LIGHTSPEED_CLIENT_ID=<YOUR_CLIENT_ID> --env LIGHTSPEED_CLIENT_SECRET=<YOUR_CLIENT_SECRET> --interactive --rm ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest

セットアップが成功したことを確認するには、Claude のターミナルで次のコマンドを実行してください。

/mcp

成功すると、Manage MCP servers の一覧に red-hat-lightspeed-mcp が表示され、その横に接続済みを示す緑色のチェックマークが付きます。

URL のオーバーライド

標準以外の RH Lightspeed URL を使用する場合は、環境変数

  • LIGHTSPEED_BASE_URL
  • LIGHTSPEED_SSO_BASE_URL
  • LIGHTSPEED_PROXY_URL を適宜設定してください。

エージェントスキル

このプロジェクトにはエージェントスキルが含まれています。これは、AI アシスタントに Red Hat Lightspeed MCP のセットアップ方法と使用方法を教える、移植可能な手順です。サポートされているアシスタント(Cursor、Claude Code など)でプロジェクトを開くと、スキルが自動的に読み込まれます。

Lola でインストール

Lola は、汎用 AI コンテキストパッケージマネージャーです。リポジトリ全体をクローンせずに、サポートされている任意の AI アシスタントに Lightspeed MCP スキルをインストールできます。

# Install Lola (one-time)
uv tool install lola-ai

# Add the Lightspeed marketplace (one-time)
lola market add rh-lightspeed https://raw.githubusercontent.com/RedHatInsights/insights-mcp/main/lola-marketplace.yml

# Install skills to your AI assistant
lola install rh-lightspeed-mcp-skills -a cursor
lola install rh-lightspeed-mcp-skills -a claude-code
lola install rh-lightspeed-mcp-skills -a gemini-cli

利用可能なスキルは .agents/skills/ ディレクトリにあります。

例

このブログ記事には、RH Lightspeed MCP サーバーの使用例がいくつか掲載されています。

MCP サーバーに接続した LLM に質問することもできます。 例:

Please explain red-hat-lightspeed-mcp and what I can do with it?

各ツールセットに固有の質問例については、テストファイルを参照してください。

CLI

ユースケースによっては、コマンドラインから MCP サーバーを直接使用する必要があります。 MCP サーバーの使用方法については、usage.md を参照してください。

リリース

この MCP サーバー向けに、2 つのコンテナーイメージが公開されています。

  • ghcr.io/redhatinsights/red-hat-lightspeed-mcp:latest
  • quay.io/redhat-services-prod/insights-management-tenant/insights-mcp/red-hat-lightspeed-mcp:latest

どちらも main ブランチをベースにしており、いずれかを使用できます。

Insights ブランドのイメージは非推奨ですが、しばらくの間は引き続き利用できます。ただし、今後削除される可能性があります。

  • ghcr.io/redhatinsights/insights-mcp:latest
  • quay.io/redhat-services-prod/insights-management-tenant/insights-mcp/insights-mcp:latest

既知の問題

Cursor

Cursor で MCP サーバーを使用すると、次のエラーが発生することがあります。

Some tools have naming issues and may be filtered out.

… exceeds 60 characters…

MCP 設定ファイル(mcp.json)内の MCP サーバー名を、より短い名前に変更してください。

{
  "mcpServers": {
    "red-hat-lightspeed-mcp-this-will-be-too-long": { # <--- rename this
…

免責事項

このソフトウェアは、明示的か黙示的かを問わず、いかなる種類の保証もなく「現状有姿」で提供されます。ご自身の責任でご使用ください。このソフトウェアの使用によって生じる損害や問題について、作者および貢献者は責任を負いません。

共有認証パッケージ

このサーバーが HTTP トランスポートのデプロイで使用する OAuth/JWT 認証プロバイダーは、Red Hat FastMCP サーバー間で共有される PyPI パッケージである rh-fastmcp-server-commonsによって提供されます。使用方法および環境変数のリファレンスについては、HACKING.mdを参照してください。

コントリビューション

詳しくは開発ガイドをご覧ください。

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。