MCP Server Rhoai

MCPAI代理

提供方 ada333

AI代理 未标注 会话登录 社区 / 第三方 Claude DesktopClaudeCursor

一个用于管理Red Hat OpenShift AI工作台的模型上下文协议(MCP)服务器,提供工作台、镜像、硬件配置和存储的创建、列表及管理功能,并监控资源消耗情况。

一句话选型结论

按资料字段整理

MCP Server Rhoai 属于AI代理类 MCP 服务器,传输方式未标注,会话登录,可直接接入 Claude Desktop、Claude、Cursor,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类AI代理 传输方式未标注 鉴权会话登录 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 21 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

AI代理
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量21暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

Kubernetes管理Go本地部署AI工作台资源监控OpenShift工具模型上下文协议

安装与配置

未标注 会话登录
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 21 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
给代理接外部能力

让代理在任务中途调用搜索、数据库等真实工具。

多步任务编排

把一串操作拆成步骤,由代理按顺序执行。

自动化重复流程

把固定流程交给代理跑,减少手工操作。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 21 个工具,覆盖面较广,能满足多种调用。
  • 已适配 Claude Desktop、Claude、Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在AI代理场景里让模型直接调用外部能力的人。
  • 已经在用 Claude Desktop、Claude 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Server Rhoai当前 21 未标注 未标注 无 2026-05-17
Filesystem 560c4363 13 未标注 本地部署 无 2026-05-17
Server Everything (everything) 11 stdio · 本地进程 本地部署 有 2026-05-17
Time 7365cb6d 2 SSE · 服务端推送 远程部署 有 2026-05-18
Everything Claude Code 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Openmemory 557e1585 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

AI代理
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ada333上游标注的维护方 ada333
分类AI代理本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.6 KB
来自项目仓库与上游目录的原文,未做删改

用于Red Hat OpenShift AI的MCP服务器

该项目实现了一个模型上下文协议(MCP)服务器,用于管理Red Hat OpenShift AI(RHOAI)工作台。它提供了用于列出、创建和管理OpenShift集群中的工作台、映像、硬件配置文件和存储的工具,还提供了用于监控每个用户、工作台、命名空间或集群的工作台资源消耗的工具。
这个项目是学士学位论文的一部分。

先决条件

  • 转到1.24.0或更高版本
  • 访问安装了RHOAI的OpenShift集群
  • oc CLI已登录到集群
  • (可选)golangci lint用于代码linting

安装

  1. 克隆存储库:```bash
    git clone https://github.com/amaly/mcp-server-rhoai.git
    cd mcp-server-rhoai

2. 下载依赖关系:```bash
go mod download
  1. 确保您已登录到OpenShift集群:```bash
    oc login

## 建筑

该项目包括一个易于构建的Makefile:

### 用Make构建```bash
# Build with linting and testing (recommended)
make build

# Build without running lint and tests (faster)
go build -o mcp-server-rhoai

构建过程将:

  1. 运行绒毛检查(golangci lint)
  2. 执行所有测试
  3. 将二进制文件编译为 mcp-server-rhoai

构建输出

  • 二进制位置: ./mcp-server-rhoai

测试

该项目有一个全面的单元测试套件(7个测试文件中的60个测试),涵盖了每个工具模块。测试使用Kubernetes假客户端(dynamicfake.NewSimpleDynamicClient)以及函数变量mocking,用于将逻辑与实时集群依赖关系隔离开来,因此不需要运行集群。

使用Make或直接使用Go运行测试:```bash

Run all tests with Make

make test

Run tests directly with verbose output

go test -v ./tools/... ./resources/... ./prompts/...


测试覆盖范围包括:

- **工作台工具** --CRUD操作、状态转换和辅助函数(图像标签解析、资源提取、PVC名称解析)
- **存储工具** --PVC创建、删除和尺寸更新,包括拒绝尺寸减小
- **图像工具** --自定义映像CRUD、默认映像和使用中的保护检查、映像列表
- **硬件配置文件工具** --配置文件CRUD和资源标识符解析
- **资源消耗工具** --值解析(毫核、Gi后缀、小数)、聚合和每个工作台/命名空间/用户/集群查询
- **命名空间和pod工具** --按命名空间列出和筛选

每个工具模块都有一个专用的 `*_test.go` 包含成功和错误路径案例的文件。在需要验证多个输入变量的情况下,使用表驱动的子测试。

## 评估

用途 Promptfoo 的 用于测试工具选择精度。

### 运行评估```bash
export GOOGLE_API_KEY=your-key-here
make eval        # run tests
make eval-view   # run and open results in browser

它测试了什么

  • 工具选择 -每个提示都需要正确的工具
  • 参数提取 -正确传递的参数(命名空间、工作台名称等)

主要学习内容

工具描述必须明确,以实现与模型无关的兼容性:

  • 用标记可选字段 omitempty 并在jsonschema描述中描述默认值
  • 在描述中包含有效值(例如,“状态:0表示运行,1表示停止”)
  • 更简单的模型(Gemini Flash)比Claude更严格——有利于测试鲁棒性

配置

MCP服务器可以在AI助手中配置,以通过自然语言实现工作台管理。

VSCode/光标设置

  1. 构建服务器:```bash
    make build

2. **在光标中打开MCP设置:**

- 按 `Ctrl + Shift + P` (Windows/Linux)或 `Cmd + Shift + P` (Mac)
- 键入“打开MCP设置”
- 点击“新建MCP服务器”

1. **添加配置:**

**只读模式** (默认,更安全):```json
{
"mcpServers": {
"mcp-server-rhoai": {
"command": "/home/amaly/mcp-server-rhoai/mcp-server-rhoai"
}
}
}

读写模式 (完全访问):```json
{
"mcpServers": {
"mcp-server-rhoai": {
"command": "/home/amaly/mcp-server-rhoai/mcp-server-rhoai",
"env": {
"MCP_RHOAI_MODE": "write"
}
}
}
}


4. **验证安装:**

- 检查服务器是否在Cursor MCP设置中启用
- 您应该看到列出的可用工具

1. **开始使用:**

- 询问AI助手:“列出命名空间mcp-test中的所有工作台”
- 或者:“显示每个命名空间的资源消耗”

### Claude桌面设置

1. **构建服务器:**```bash
make build
  1. 找到Claude Desktop配置文件:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 窗户: %APPDATA%\Claude\claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  1. 编辑配置文件 并添加MCP服务器:

只读模式 (默认):```json
{
"mcpServers": {
"mcp-server-rhoai": {
"command": "/home/amaly/mcp-server-rhoai/mcp-server-rhoai"
}
}
}


**读写模式** (完全访问):```json
{
"mcpServers": {
"mcp-server-rhoai": {
"command": "/home/amaly/mcp-server-rhoai/mcp-server-rhoai",
"env": {
"MCP_RHOAI_MODE": "write"
}
}
}
}
  1. 重新启动克劳德桌面 使更改生效

  2. 验证连接:

  • 在Claude Desktop中查找MCP连接指示灯
  • 问Claude:“我的集群中有哪些工作台?”

重要说明

权限: MCP服务器使用您当前的 oc 登录凭据。所有操作都是在您的用户权限下执行的。

安全: 从只读模式开始,安全探索。仅在需要创建或修改资源时启用写入模式。

工具模式

服务器支持两种操作模式,既安全又灵活:

只读模式(默认)

只有列表和查询工具可用。此模式为 更安全 并防止对集群的意外修改。

可用操作:

  • 列出工作台、图像、硬件配置文件、PVC
  • 查询资源消耗
  • 查看命名空间和pod信息

读写模式

所有工具都可用,包括创建、删除和修改操作。

附加操作:

  • 创建/删除工作台
  • 创建/删除自定义图像
  • 创建/删除硬件配置文件
  • 创建PVC
  • 启动/停止工作台

配置模式

可以通过命令行标志或环境变量设置模式:

命令行标志(建议用于promptfoo/scripts):```bash
./mcp-server-rhoai -mode write


**环境变量(用于MCP客户端配置):**```bash
export MCP_RHOAI_MODE=write
值 模式 描述
未设置 只读 默认安全模式
write 读写 完全访问所有工具

这 -mode 标志优先于环境变量。

可用工具

只读工具(始终可用)

  • 列出Pod -在命名空间中列出Pod
  • 列出命名空间 -列出群集中的所有命名空间
  • 列出工作台 -列出特定命名空间中的工作台
  • 列出所有工作台 -列出所有命名空间中的工作台
  • 列出图片 -列出所有可用的笔记本图像
  • 列出硬件配置文件 -列出可用的硬件配置文件
  • 列出PVC -在命名空间中列出持久卷声明
  • 列出每个工作台的资源消耗 -获取特定工作台的资源使用情况
  • 列出每个命名空间的资源消耗 -获取命名空间中所有工作台的资源使用情况
  • 列出每个用户的资源消耗 -获取特定用户的资源使用情况
  • 列出每个群集的资源消耗 -获取集群范围内的资源使用情况

写入工具(仅在写入模式下)

  • 创建工作台 -使用指定配置创建新工作台
  • 删除工作台 -删除现有工作台
  • 更改工作台状态 -启动或停止工作台
  • 创建自定义图像 -创建自定义笔记本映像
  • 删除图像 -删除自定义图像
  • 创建硬件配置文件 -创建新的硬件配置文件
  • 删除硬件配置文件 -删除硬件配置文件
  • 创建PVC -创建持久卷声明

发展

项目结构```

mcp-server-rhoai/
├── main.go # Entry point
├── core/ # Shared types and utilities
│ ├── gvr.go # Kubernetes GroupVersionResource definitions
│ ├── common_types.go # Shared output/namespace types
│ ├── workbench_types.go # Workbench-related types
│ ├── image_types.go # Image-related types
│ ├── hardware_profile_types.go # Hardware profile types
│ ├── pvc_types.go # PVC-related types
│ ├── resource_consumption_types.go # Resource consumption types
│ └── logging.go # Logging utilities
├── tools/ # MCP tool implementations
│ ├── registry.go # Tool registration (read-only & write modes)
│ ├── workbench_tools.go # Workbench CRUD & status tools
│ ├── image_tools.go # Image management tools
│ ├── hardware_profile_tools.go # Hardware profile tools
│ ├── storage_tools.go # PVC management tools
│ ├── namespace_tools.go # Namespace listing tools
│ ├── pod_tools.go # Pod listing tools
│ ├── resource_consumption_tools.go # Resource monitoring tools
│ └── common.go # Shared tool helpers
├── resources/ # MCP resource definitions
├── prompts/ # MCP prompts
└── Makefile # Build automation


### 添加新工具

1. 在相应的文件中实现工具功能 `tools/`
1. 在中注册 `tools/registry.go`:
- 只读:添加到 `RegisterReadOnlyTools()`
- 写作:添加到 `RegisterWriteTools()`
1. 在中添加测试 `tools/*_test.go`
1. 更新此自述文件

## 代码检查

此存储库使用 戈朗茨皮棉 用于代码质量检查。

### 安装golangci棉绒```bash
go install github.com/golangci/golangci-lint/cmd/golangci-lint@latest

跑林婷```bash

make lint
```

常见问题

6 问
答案由本站依据条目字段整理,不引用上游原文
MCP Server Rhoai 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

MCP Server Rhoai 怎么在 Claude Desktop、Claude、Cursor 里配置?

它的传输方式未标注,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

MCP Server Rhoai 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Server Rhoai 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

MCP Server Rhoai 支持哪些客户端?

资料标注支持 Claude Desktop、Claude、Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

MCP Server Rhoai 能提供哪些能力?

资料显示约 21 个工具;能力标签包括 Kubernetes管理、Go、Claude。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。