Red Hat Lightspeed MCP

Name: Red Hat Lightspeed MCP
Author: RedHatInsights

本地服务

github.com/RedHatInsights云与基础设施251 天前更新

代码仓库

关于 Red Hat Lightspeed MCP

Red Hat Lightspeed MCP 是面向 LLM Agent 的可自托管 MCP 服务，将 Red Hat Lightspeed 多项服务接入 MCP 客户端。默认仅支持只读操作，也可通过配置启用写入工具并受 RBAC 权限约束。

主要功能

01连接多项 Lightspeed 服务
02默认只读操作
03可选启用写入工具
04支持自然语言查询
05按 RBAC 权限限制操作

适用场景

01查询 Advisor 建议与库存
02检查漏洞和修复信息
03管理镜像构建计划
04通过自然语言查询 Lightspeed 服务

MCP 相关

该 MCP 服务向 LLM Agent 暴露 Red Hat Lightspeed 的 Advisor、Inventory、Vulnerability、Image Builder 等服务操作。默认工具为只读，写入工具可选启用并受账户权限限制。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 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-mcpstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

Red Hat Lightspeed MCP

（原名 Insights MCP）

Red Hat Lightspeed Model Context Protocol（MCP）服务是一种轻量级、可自托管的解决方案，可将基于大模型的 Agent（例如 Claude Desktop 和其他兼容 MCP 的工具）连接到 Red Hat Lightspeed 服务。

功能

支持只读操作：服务默认以只读模式运行。使用 --all-tools 可启用写入工具（例如创建蓝图、运行 compose）。RBAC 权限也可以限制访问。
提供自然语言提示词：支持使用自然语言查询 Red Hat Lightspeed 服务

支持的 Lightspeed 服务

设置和使用

身份验证

注意：只有访问 Red Hat Lightspeed API 时才需要身份验证。MCP 服务本身不需要身份验证。

有两种身份验证方式：

服务帐户（client_id + client_secret）——创建服务帐户，并通过环境变量或 HTTP 标头提供凭据。
JWT Bearer Token——通过 Authorization: Bearer <token> HTTP 标头提供现有 JWT 令牌（仅适用于 SSE/HTTP 传输）。

服务帐户设置

前往 https://console.redhat.com → 点击 Settings（⚙️ 齿轮图标）→ "Service Accounts"
创建服务帐户，并记下 Client ID 和 Client secret，以供后续使用。
请参阅下方的集成说明，其中分别将它们称为 LIGHTSPEED_CLIENT_ID 和 LIGHTSPEED_CLIENT_SECRET。

各工具集所需的权限

不同的工具集需要服务帐户具有特定角色：

Advisor 工具：RHEL Advisor viewer、Inventory Hosts viewer
OCP Advisor 工具：OCP Advisor administrator
清单工具：Inventory Hosts viewer、Workspace viewer
漏洞工具：Vulnerability viewer、Inventory Hosts viewer
修复工具：Remediations user
镜像构建器工具：Repositories viewer
RHSM 工具：RHC user
内容源工具：Repositories viewer
规划工具：Inventory Hosts viewer

这些名称是 Hybrid Cloud Console 用户访问页面上显示的名称。请勿在帐户之间复制角色详情 URL；其中包含特定于租户的标识符。合并的 RHEL viewer 角色可替代上述若干 viewer 角色。

向服务账号授予权限

默认情况下，服务账号没有任何访问权限。组织管理员必须分配权限。MCP 服务只能执行其拥有权限执行的任务。例如，如果用户希望允许只读操作并拒绝写入操作，可以通过权限系统实现。

有关详细的分步说明，请参阅此视频教程：服务账号权限设置

以组织管理员身份登录，并具有用户访问管理员角色
导航到用户访问设置：点击设置（⚙️ 齿轮图标）→ "User Access" → "Groups"
分配权限（选择一种方式）：

方式 A - 创建新组：
- 创建新组（例如 mcp-service-accounts）
- 添加所需角色（例如 RHEL Advisor viewer、Inventory Hosts viewer 等）
- 将你的服务账号添加到此组
方式 B - 使用现有组：
- 打开具有所需角色的现有组
- 转到 "Service accounts" 选项卡
- 将你的服务账号添加到该组

你的服务账号将继承所分配组的所有角色。

⚠️ 安全提示 ⚠️

如果你在本地启动此 MCP 服务（使用 podman 或 docker），请确保容器未暴露到互联网。在这种情况下，使用 LIGHTSPEED_CLIENT_ID 和 LIGHTSPEED_CLIENT_SECRET 可能没有问题，尽管你的 MCP 客户端（例如 VSCode、Cursor 等）可以获取你的 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 行为、意外数据暴露或怀疑令牌泄露时，操作人员必须能够迅速切断已连接的大模型对 Red Hat Lightspeed 的访问。

紧急"终止开关"流程：

如果你需要立即撤销 AI 对工具集的访问，请执行以下步骤：

终止服务： 立即停止 MCP 容器或本地进程（例如运行 podman ps 找到容器，然后运行 podman stop <container_id>）。
撤销凭证： 使 MCP 服务用于向 Red Hat 服务进行身份验证的 Red Hat Client ID 失效。转到 "Service Accounts" 页面并 Delete 或 Reset 凭证。

此外，你可以从本地大模型客户端的配置中移除 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：一键安装（最简单）

该徽章使用 HTTPS 重定向（goose-docs.ai/extension?...），会打开 Goose Desktop 的扩展安装流程。

(注意：这里使用的是 quay.io 容器镜像，并以 docker 作为命令——Goose 深度链接仅支持 docker，不支持 podman。如果你依赖 Podman，请使用下面的手动安装。)

点击后，Goose 会提示输入 LIGHTSPEED_CLIENT_ID 和 LIGHTSPEED_CLIENT_SECRET，然后安装该扩展。启动一个新的聊天会话来使用它。

方案 2：手动 STDIO 安装

点击左上角的按钮打开侧边栏。
点击侧边栏上的 Extensions 按钮。
在 Extensions 下，点击 Add custom extension。
在 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）
点击 Add。

Docker 用户可以在命令中将 podman 替换为 docker。在 macOS 上，如果 Goose 找不到 podman，请使用 which podman 得到的完整路径（见前提条件）。

Cursor

先查看前提条件部分。

方案 1：一键安装（最简单）

⚠️ 使用 Ctrl/Cmd-点击在新标签页中打开。
否则标签页会在安装后关闭，你就看不到文档了。

(注意：这里使用的是 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 Bearer token：

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

VSCode

首先查看前提条件部分。

选项 1：一键安装（最简单）

（注意：这里使用的是 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 Bearer token：

{
    ...
    "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"
    }
  }
}

请确保 type 为 sse，因为 CLine 尚不支持 HTTP 传输。

通用 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，而不是聊天界面。你需要一个具备“agent capabilities”的 MCP 客户端来连接 red-hat-lightspeed-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

Agent Skills

本项目包含 Agent Skills — 可移植的说明，用于指导 AI 助手设置和使用 Red Hat Lightspeed MCP。在受支持的助手（Cursor、Claude Code 等）中打开项目时，系统会自动加载这些技能。

使用 Lola 安装

Lola 是一款通用 AI 上下文包管理器。使用它可将 Lightspeed MCP 技能安装到任何受支持的 AI 助手中，无需克隆整个仓库：

# 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 服务的大模型提问。例如：

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

如需了解针对各工具集的示例问题，请查看测试文件：

CLI

在某些使用场景中，可能需要直接从命令行使用 MCP 服务。有关 MCP 服务的用法，请参阅 usage.md。

发布

此 MCP 服务发布了两个容器镜像。

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 身份验证提供程序由 rh-fastmcp-server-commons 提供，这是一个由 Red Hat FastMCP 服务共用的 PyPI 软件包。有关用法和环境变量参考，请参阅 HACKING.md。

贡献

请参阅hacking guide了解更多信息。

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。

Red Hat Lightspeed MCP

关于 Red Hat Lightspeed MCP

主要功能

适用场景

MCP 相关

配置

工具

详细介绍

Red Hat Lightspeed MCP

功能

支持的 Lightspeed 服务

设置和使用

身份验证

服务帐户设置

各工具集所需的权限

向服务账号授予权限

⚠️ 安全提示 ⚠️

安全与事件响应（紧急撤销）

技术信息

工具集

集成

前提条件

Goose Desktop

方案 1：一键安装（最简单）

方案 2：手动 STDIO 安装

Cursor

方案 1：一键安装（最简单）

选项 2：手动 STDIO 安装

选项 3：手动 Streamable HTTP 安装（高级）

VSCode

选项 1：一键安装（最简单）

选项 2：手动 STDIO 安装

Gemini CLI

选项 1：手动 STDIO 安装

选项 2：手动 Streamable HTTP 安装（高级）

Claude Desktop

配合 VSCode 使用 CLine

通用 STDIO

Claude Code

URL 覆盖

Agent Skills

使用 Lola 安装

示例

CLI

发布

已知问题

Cursor

免责声明

共享身份验证包

贡献

评论

第一次接触 MCP？

MCP（Model Context Protocol）是什么？

MCP 服务和客户端有什么区别？

本地服务与远程服务怎么选？

如何在 Claude、Cursor 等客户端中安装服务？

收录的项目经过审核吗？“认证”标识代表什么？

我维护的项目已被收录，怎样认领？