Redhat API MCP

Red Hat API MCP服务器

  

该项目实现了 模型上下文协议（MCP） 提供交互工具的服务器 红帽API，使其易于与LLM应用程序集成。

目录

• 特性
• 先决条件
• 安装
• 配置
• 用法
• 可用工具
• 例子
• 故障排除
• 高级用法
• 贡献

特性

服务器公开以下Red Hat API工具：

1. 搜索红帽KCS解决方案 -搜索知识库解决方案
2. 按ID获取解决方案 -检索完整的解决方案内容
3. 搜索红帽案例 -查找与查询匹配的案例
4. 获取案例详细信息 -检索特定案例的详细信息

先决条件

• Python 3.13或更高版本
• UV包管理器 （推荐使用Python包管理器）
• Red Hat API离线令牌（从您的Red Hat帐户获取）

安装

1.安装UV（如果尚未安装）

2.克隆和设置项目

git clone 
cd redhat-api-mcp
uv sync

配置

1.获取您的Red Hat API代币

1. 访问 Red Hat API代币管理页面 每 KCS
2. 登录您的Red Hat帐户
3. 生成离线令牌
4. 安全地复制和保存令牌

2.环境设置

创建一个 .env 使用您的Red Hat API令牌在项目根目录中创建文件：

# Create .env file
echo "RH_API_OFFLINE_TOKEN=your_offline_token_here" > .env

替换 your_offline_token_here 使用步骤1中的实际离线令牌。

用法

与MCP Inspector一起开发

您可以使用MCP开发工具测试服务器：

uv run mcp dev redhat_mcp_server.py

这将启动MCP检查器，允许您与工具进行交互。

与Claude Desktop集成

要在Claude Desktop中安装服务器，请将此配置添加到您的Claude Desktop配置文件中。

{
  "mcpServers": {
    "redhat": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/your/redhat-api-mcp",
        "run",
        "redhat_mcp_server.py"
      ],
      "env": {
        "RH_API_OFFLINE_TOKEN": "your_actual_offline_token_here"
      }
    }
  }
}

可用工具

search_kcs

搜索Red Hat KCS解决方案和文章。

search_kcs(query: str, rows: int = 50, start: int = 0) -> List[Dict]

参数：

• query （str）：搜索词（支持高级Solr语法）
• rows （int，可选）：要返回的结果数（默认值：50，最大值：100）
• start （int，可选）：分页的起始索引（默认值：0）

退货： 包含id、标题、分数和view_uri的解决方案对象列表

get_kcs

通过ID获取红帽解决方案并提取结构化内容。

get_kcs(solution_id: str) -> Dict

参数：

• solution_id （str）：KCS解决方案ID

退货： 包含标题、环境、问题、解决方案和root_cause的词典

搜索案例

搜索Red Hat支持案例。

search_cases(query: str, rows: int = 10, start: int = 0) -> List[Dict]

参数：

• query （str）：搜索词
• rows （int，可选）：要返回的结果数（默认值：10）
• start （int，可选）：分页的起始索引（默认值：0）

退货： 案例对象列表，包括案例编号、摘要、状态、产品等。

get_case

获取有关特定红帽支持案例的详细信息。

get_case(case_number: str) -> Dict

参数：

• case_number （str）：红帽案例编号（例如“01234567”）

退货： 详细的病例信息，包括摘要、描述、严重程度和评论

高级用法

高级查询参数

有关在Red Hat Hydra API中使用高级Solr查询表达式的详细信息，请参阅 表情.md.

提示模板

服务器包括用于案例分析的复杂提示模板：

• 案例总结：生成C.A.S.E.格式摘要
• 案件解决：提供调查工作流程
• 多相分析：高级病例解决方案

自定义配置

您可以通过将默认API端点添加到您的 .env 文件：

# Optional: Custom API endpoints
RH_API_BASE_URL=https://access.redhat.com
RH_SSO_URL=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

备注：此MCP服务器需要有效的Red Hat帐户和API访问权限。确保您对要访问的Red Hat服务拥有适当的权限。