ols MCP

OpenShift光速MCP服务器

一个模型上下文协议（MCP）服务器，将OpenShift LightSpeed功能与Claude Code集成在一起，实现了人工智能驱动的OpenShift辅助和故障排除。

概述

此MCP服务器为Claude Code提供了对OpenShift LightSpeed的访问，允许用户直接在其开发工作流程中获得专家OpenShift指导、故障排除帮助和最佳实践。

特性

• OpenShift专业知识：获取OpenShift相关问题的答案和故障排除指南
• 无缝集成：直接在Claude Code中工作，以增强开发体验
• 可配置的：针对不同OpenShift LightSpeed部署的灵活配置
• 错误处理：强大的错误处理和超时管理

安装

先决条件

• Python 3.12+
• 紫外线 包管理器
• 访问OpenShift LightSpeed API端点

设置

1. 克隆和安装依赖关系：

   cd ols-mcp
   uv sync

1. 配置环境：

   cp .env.example .env
   # Edit .env with your OLS API configuration

1. 测试服务器：

   uv run python -m ols_mcp.server

配置

环境变量

使用环境变量或 .env 文件：

示例 .env 文件：

OLS_API_URL=https://your-ols-instance.com
OLS_API_TOKEN=your-bearer-token-here
OLS_TIMEOUT=30.0
OLS_VERIFY_SSL=true

Claude代码集成

要将此MCP服务器与Claude Code一起使用，请将其添加到您的Claude Code配置中：

配置文件位置

• Linux/macOS: ~/.config/claude-code/config.json
• 视窗: %APPDATA%\claude-code\config.json

配置示例

将以下内容添加到您的 config.json:

{
  "mcpServers": {
    "openshift-lightspeed": {
      "command": "uv",
      "args": ["run", "python", "-m", "ols_mcp.server"],
      "cwd": "/path/to/your/ols-mcp",
      "env": {
        "OLS_API_URL": "https://your-ols-instance.com",
        "OLS_API_TOKEN": "your-token-here",
        "OLS_TIMEOUT": "30.0",
        "OLS_VERIFY_SSL": "true"
      }
    }
  }
}

重要：更新 cwd 指向你的实际路径 ols-mcp 目录。

验证

1. 添加配置后重新启动Claude Code
2. 这 openshift-lightspeed 工具现在应该可用
3. 使用OpenShift相关问题进行测试

用法示例

一旦与Claude Code集成，您可以提出以下问题：

• “帮助我排除无法启动的吊舱故障”
• “我如何在OpenShift中扩展部署？”
• “我的应用程序出现503个错误，我应该检查什么？”
• “演示如何为我的服务创建路由”
• “配置资源限制的最佳方法是什么？”

Claude Code将自动使用OpenShift LightSpeed MCP服务器提供专家级的OpenShift指导。

发展

项目结构

ols-mcp/
├── pyproject.toml              # uv project configuration
├── .env.example               # Environment configuration template
├── src/ols_mcp/
│   ├── __init__.py
│   ├── models.py              # Pydantic models for requests/responses
│   ├── client.py              # HTTP client for OLS API communication
│   └── server.py              # MCP server implementation
└── README.md                  # This file

可用工具

服务器提供以下MCP工具：

• openshift-lightspeed：向OpenShift LightSpeed提交查询并获得专家指导

错误处理

该服务器包括全面的错误处理功能，用于：

• 网络连接问题
• API身份验证失败
• 超时情况
• 无效响应
• SSL证书问题

故障排除

常见问题

1. 连接被拒绝：检查一下 OLS_API_URL 正确，服务正在运行
2. 身份验证错误：验证您的 OLS_API_TOKEN 有效且具有适当的权限
3. SSL错误：对于自签名证书，设置 OLS_VERIFY_SSL=false
4. 超时问题：增加 OLS_TIMEOUT 对于较慢的网络

调试模式

使用调试日志运行服务器：

DEBUG=1 uv run python -m ols_mcp.server

贡献

本项目使用：

• 紫外线 用于依赖关系管理
• 派丹蒂克 用于数据验证
• httpx 用于HTTP客户端功能
• MCP-SDK 用于协议实施

许可证

该项目是OpenShift生态系统的一部分，遵循红帽的开源实践。