OpenShift MCP Server

Architecture

Q Quarkus MCP Server

Custom Java server with 19 operational tools for monitoring, deployment, and performance testing. Built with Fabric8 Kubernetes Client.

checkClusterHealth
getPerformanceMetrics
createDeployment
deployDatabase
runKubeBurner
+ 14 more tools

K Kubernetes MCP Server

Official Go-based server from openshift/openshift-mcp-server. Generic CRUD, pod management, Helm operations.

resources_list / get / create / delete
pods_exec / pods_log
helm_install / helm_list
events_list / namespaces_list
nodes_top / pods_top
+ 10 more tools

+ Supporting Services

Included in the Helm chart for a complete AI-assisted operations stack.

MCP Inspector (testing UI)
LiteLLM Proxy (OpenAI compat)
PostgreSQL (LiteLLM backend)

Helm Chart

Version	App Version	Description
`0.1.0-alpha`	`0.1.0-alpha`	Dual MCP server + Inspector + LiteLLM (experimental)

Add the Helm Repository

helm repo add openshift-mcp https://maximilianoPizarro.github.io/openshift-mcp-server
helm repo update

Install

helm install openshift-mcp-server openshift-mcp/openshift-mcp-server \
  --namespace openshift-lightspeed \
  --set namespace=openshift-lightspeed \
  --set serviceAccount.create=true

Configure with an existing RHOAI model

helm install openshift-mcp-server openshift-mcp/openshift-mcp-server \
  --namespace openshift-lightspeed \
  --set namespace=openshift-lightspeed \
  --set litellm.model.name=llama-32-3b-instruct \
  --set litellm.model.modelId=llama-32-3b-instruct \
  --set litellm.model.apiBase=http://llama-32-3b-instruct-openai.my-first-model.svc.cluster.local/v1

Custom Tools (Quarkus Server)

Monitoring (9 tools)

Tool	Description
`checkClusterHealth`	Overall cluster health, node/pod status, critical issues
`getPerformanceMetrics`	Node and pod CPU/memory metrics
`detectResourceIssues`	Pods with high CPU/memory or excessive restarts
`analyzePodDisruptions`	Evictions, OOM kills, restart patterns
`checkNodeConditions`	Node conditions, taints, allocatable resources
`monitorDeployments`	Deployment rollout health and replica status
`checkKubeletStatus`	Kubelet service status and journal logs
`checkCrioStatus`	CRI-O container runtime status
`analyzeJournalctlPodErrors`	Journal log analysis with filters

Deployment (5 tools)

Tool	Description
`createDeployment`	Create deployments with custom config
`deployDatabase`	Deploy PostgreSQL/MySQL/MongoDB/Redis (RHEL images)
`createHpa`	Configure horizontal pod autoscalers
`createService`	Create ClusterIP/NodePort/LoadBalancer services
`createNetworkPolicy`	Create network policies

Performance Testing (5 tools)

Tool	Description
`runKubeBurner`	Cluster density testing
`runStorageBenchmark`	Storage I/O benchmarks with FIO
`runNetworkTest`	Network throughput with iperf3
`runCpuStressTest`	CPU/memory stress testing
`runDatabaseBenchmark`	Database benchmarks

Kubernetes MCP Tools (Official Server)

Toolset	Tools
Config	`configuration_contexts_list`, `targets_list`, `configuration_view`
Core	`resources_list`, `resources_get`, `resources_create_or_update`, `resources_delete`, `resources_scale`, `pods_list`, `pods_get`, `pods_delete`, `pods_top`, `pods_exec`, `pods_log`, `pods_run`, `namespaces_list`, `projects_list`, `events_list`, `nodes_top`, `nodes_log`
Helm	`helm_install`, `helm_list`, `helm_uninstall`

OLSConfig Integration

apiVersion: ols.openshift.io/v1alpha1
kind: OLSConfig
metadata:
  name: cluster
spec:
  featureGates:
    - MCPServer
  mcpServers:
    - name: openshift-mcp-server
      timeout: 30
      url: 'http://openshift-mcp-server.openshift-lightspeed.svc.cluster.local:8080/mcp'
    - name: kubernetes-mcp-server
      timeout: 30
      url: 'http://openshift-mcp-server-k8s-mcp.openshift-lightspeed.svc.cluster.local:8085/mcp'

Technology Stack

Component	Technology
Custom MCP Server	Quarkus 3.27.3 + Fabric8 Kubernetes Client
Official MCP Server	Go (openshift/openshift-mcp-server)
MCP Protocol	Streamable HTTP (POST /mcp)
Container Runtime	UBI9 OpenJDK 21 Runtime
Helm Chart	v2 with 5 deployments
LLM Integration	LiteLLM proxy (OpenAI compatible)

Helm Chart Components

Component	Image	Port	Description
openshift-mcp-server	`quay.io/maximilianopizarro/openshift-mcp-server`	8080	Custom Quarkus MCP
kubernetes-mcp-server	`quay.io/redhat-user-workloads/.../openshift-mcp-server`	8085	Official K8s MCP
mcp-inspector	`mcpuse/inspector`	8080	MCP testing UI
litellm	`litellm/litellm-non_root`	4000	OpenAI-compatible proxy
litellm-db	`registry.redhat.io/rhel9/postgresql-15`	5432	PostgreSQL backend