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

如果未设置 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。以 JSON 格式返回集群 ID 和 infraenv ID。

  • 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 版本和 Operator

• list_versions - 列出可通过 assisted installer 安装的 OpenShift 版本

• list_operator_bundles - 列出安装期间可选添加到集群的 Operator bundle

• add_operator_bundle_to_cluster - 请求在指定集群中安装 Operator bundle

  • cluster_id：集群 ID（字符串，必填）
  • bundle_name：Operator bundle 名称（字符串，必填）

使用示例

• 列出所有集群：“显示我的所有集群”
• 获取集群详细信息：“提供集群 abc123 的详细信息”
• 创建集群：“创建一个名为 'my-cluster'、使用 OpenShift 4.14 且基础域名为 'example.com' 的新集群”
• 检查集群事件：“集群 abc123 上发生了哪些事件？”
• 安装集群：“开始安装集群 abc123”