Ermöglicht es KI-Assistenten, OpenShift- und Kubernetes-Cluster mithilfe der oc CLI für das Deployment, das Scaling und das Troubleshooting von Ressourcen zu verwalten.
Auch bekannt als sanjaypsachdev/mcp-server-openshift, mcp-server-openshift
- Stars
- 1
- Tools
- 13
- Downloads, 30 Tage
- —
- Neueste Version
- 1.2.0
- Letzter Commit
- 28. Okt. 2026
- Lizenz
- MIT
Was ist OpenShift MCP?
Ermöglicht es KI-Assistenten, OpenShift- und Kubernetes-Cluster mithilfe der oc CLI für das Deployment, das Scaling und das Troubleshooting von Ressourcen zu verwalten. Er stellt 13 Tools bereit, etwa oc_login, oc_api_resources, oc_explain.
Zusammenfassung generiert aus dem README des Projekts
Über OpenShift MCP server
Mit diesem MCP server ist es möglich, OpenShift- und Kubernetes-Cluster über einen KI-Assistenten zu verwalten. Er verbindet deinen KI-Client mit der oc Command-Line Interface, was eine direkte Cluster-Administration, das Deployment von Ressourcen und Troubleshooting ermöglicht. Entwickler können ihn lokal via stdio oder remote über HTTP/SSE-Transports nutzen. Für den Betrieb benötigt die Umgebung Node.js 20 oder höher, die installierte und konfigurierte oc CLI sowie einen aktiven Zugriff auf einen OpenShift-Cluster.
Der Server bietet eine breite Palette an Tools für den gesamten Application Lifecycle. Du kannst oc_new_app verwenden, um Anwendungen aus Git-Repositories mittels S2I-Builds zu deployen, oder oc_scale, um die Anzahl der Replicas für Deployments und Statefulsets anzupassen. Er enthält zudem fortgeschrittene Funktionen wie oc_install_operator zur Verwaltung von Operatoren via OLM oder Helm. Für die Wartung bietet der Server Log-Sampling zur intelligenten Mustererkennung sowie spezialisierte Troubleshooting-Prompts, um Probleme mit dem Cluster oder Ressourcen zu lösen.
Was du damit machen kannst
- 1Deployen von Anwendungen aus GitEine KI kann eine komplette Anwendung aus einem GitHub-Repository mittels S2I-Builds und automatischer Route-Erstellung deployen.
- 2Troubleshooting von Cluster-ProblemenDer Server bietet interaktive Guides, um Probleme mit Pods, Deployments oder der allgemeinen Cluster-Health zu diagnostizieren.
- 3Analyse von Pod-LogsEine KI kann Logs sampeln und analysieren, um Fehlermuster zu erkennen und Kontext für Ausfälle zu liefern.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du OpenShift MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenOpenShift MCP in Claude Code installieren
$ claude mcp add mcp-server-openshift -- npx -y mcp-server-openshiftOpenShift MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server-openshift": {
"command": "npx",
"args": [
"-y",
"mcp-server-openshift"
]
}
}
}OpenShift MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp-server-openshift": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-server-openshift"
]
}
}
}OpenShift MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp-server-openshift","type":"stdio","command":"npx","args":["-y","mcp-server-openshift"]}'OpenShift MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp-server-openshift": {
"command": "npx",
"args": [
"-y",
"mcp-server-openshift"
]
}
}
}OpenShift MCP in Codex installieren
$ codex mcp add mcp-server-openshift -- npx -y mcp-server-openshiftOpenShift MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp-server-openshift] command = "npx" args = ["-y", "mcp-server-openshift"]
OpenShift MCP in Gemini CLI installieren
$ gemini mcp add -s user mcp-server-openshift npx -- -y mcp-server-openshiftOpenShift MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp-server-openshift": {
"command": "npx",
"args": [
"-y",
"mcp-server-openshift"
]
}
}
}OpenShift MCP tools 13
Erkannt aus dem READMEoc_loginoc_api_resourcesoc_explainoc_getoc_createoc_applyoc_deleteoc_patchoc_describeoc_new_appoc_scaleoc_logs
| oc_login | — | |
| oc_api_resources | — | |
| oc_explain | — | |
| oc_get | — | |
| oc_create | — | |
| oc_apply | — | |
| oc_delete | — | |
| oc_patch | — | |
| oc_describe | — | |
| oc_new_app | — | |
| oc_scale | — | |
| oc_logs | — |
Alle 13 Tools anzeigenWeniger Tools anzeigen
oc_install_operator
| oc_install_operator | — |
Konfiguration
OPENSHIFT_CONTEXTDefault OpenShift/Kubernetes context
OPENSHIFT_CONTEXTDefault OpenShift/Kubernetes context
OPENSHIFT_NAMESPACEDefault namespace/project
OPENSHIFT_NAMESPACEDefault namespace/project
| Name | Beschreibung | Typ |
|---|---|---|
| OPENSHIFT_CONTEXT | Default OpenShift/Kubernetes context | |
| OPENSHIFT_CONTEXT | Default OpenShift/Kubernetes context | |
| OPENSHIFT_NAMESPACE | Default namespace/project | |
| OPENSHIFT_NAMESPACE | Default namespace/project |
Automatisierte Checks
Geluften am 13. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarBestanden
- Open Source Lizenz (OSI)Bestanden
- Commit oder Release im letzten JahrBestanden
- Package-Name ähnelt keinem populären PackageBestanden
- Remote Endpoint nutzt HTTPSNicht geprüft
- Destruktive Tools sind markiertBestanden
- Keine versteckten Anweisungen an das ModellBestanden
- Keine kritischen Advisories im Paket oder seinen AbhängigkeitenBestanden
README
Auf GitHub ansehenOpenShift MCP Server
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive OpenShift/Kubernetes cluster management capabilities through the oc command-line interface.
Demo Video
Watch the oc-new-app tool deploy a complete Spring Boot application from GitHub to OpenShift:
https://github.com/user-attachments/assets/f4bace3f-755b-462f-8a8a-680e4dc02129
Features
- Cluster Information: Access comprehensive cluster status, nodes and configuration via MCP resources
- Resource Description: Describe any resource with multiple output formats including human-readable summaries
- Complete Resource Management: Create, read, update, delete, and patch all OpenShift/Kubernetes resources
- Application Deployment: Deploy applications from Git repositories with S2I builds and automatic route creation
- Operator Management: Install operators via OLM, Helm, or direct manifests
- Cluster Operations: Scaling, monitoring, troubleshooting and management
- Build Operations: Start and monitor OpenShift builds
- Scaling Operations: Scale deployments, replicasets and statefulsets
- Logging: Retrieve logs from pods and builds
- Multi-Transport Support: STDIO and HTTP/SSE transports for different integration scenarios
- Comprehensive Testing: 99 unit tests ensuring production reliability
- Rich Error Handling: Detailed troubleshooting guidance and actionable error messages
- Troubleshooting Prompts: Interactive troubleshooting guides for common OpenShift scenarios
- Log Sampling: Sample and analyze pod logs with intelligent pattern detection and context
Prerequisites
- Node.js 20+
- OpenShift CLI (
oc) installed and configured - Access to an OpenShift cluster
Installation
git clone https://github.com/sanjaypsachdev/mcp-server-openshift.git
cd mcp-server-openshift
npm install
npm run build
Configuration
Add to your MCP client configuration:
Claude Desktop / Cursor
{
"mcpServers": {
"openshift": {
"command": "node",
"args": ["/path/to/mcp-server-openshift/dist/index.js"],
"env": {
"OPENSHIFT_CONTEXT": "your-context-name",
"OPENSHIFT_NAMESPACE": "your-default-namespace"
}
}
}
}
HTTP/SSE Transport (Remote Access)
# Start HTTP server
npm run start:http
# Connect via MCP remote
npx -y mcp-remote http://localhost:3000/sse --transport sse-only
Tools
Authentication & Access
oc_login- Securely log into OpenShift clusters using token or username/password authentication
API Discovery & Documentation
oc_api_resources- List all available API resources in the cluster with categorizationoc_explain- Explain resource schemas, fields, and API documentation
Core Resource Management
oc_get- Get OpenShift resources (pods, deployments, services, routes, etc.)oc_create- Create OpenShift resources from manifests or templatesoc_apply- Apply YAML manifests with validation and conflict resolutionoc_delete- Delete resources with safety checks and confirmation optionsoc_patch- Patch resources using strategic merge, JSON merge, or JSON patch operationsoc_describe- Describe resources with multiple output formats
Application Lifecycle
oc_new_app- Deploy applications from Git repositories with S2I buildsoc_scale- Scale deployments, deploymentconfigs, replicasets, and statefulsetsoc_logs- Get logs from pods, deployments, builds with filtering options
Advanced Operations
oc_install_operator- Install operators via OLM, Helm, or direct manifests
Resources
MCP Resources provide read-only access to cluster information:
openshift://cluster-info- Comprehensive cluster status, nodes, namespaces, and eventsopenshift://project-list- Detailed project information with quotas and usage statisticsopenshift://app-templates- Application deployment templates and patterns
Prompts
Interactive troubleshooting and operational guidance:
troubleshoot-openshift-prompt- Comprehensive OpenShift troubleshooting guide for all resource types and cluster issuesmonitoring-prompts- Monitoring and observability guidance for different scenarios
Sampling
Intelligent log analysis and pattern detection:
- Pod Logs Sampling - Automatic log sampling with error pattern detection and context analysis
Usage Examples
Login to Cluster
# Login with token (recommended)
oc_login with server: "https://api.cluster.example.com:6443",
authMethod: "token",
token: "sha256~your-token-here"
# Login with username/password
oc_login with server: "https://api.cluster.example.com:6443",
authMethod: "password",
username: "developer",
password: "your-password"
Discover API Resources
# List all available API resources
oc_api_resources
# List resources for specific API group
oc_api_resources with apiGroup: "apps"
# List only namespaced resources
oc_api_resources with namespaced: true
# Explain a resource schema
oc_explain with resource: "deployment"
# Explain specific field
oc_explain with resource: "pod", field: "spec.containers"
Deploy Application
# Deploy Node.js app from GitHub
oc_new_app with gitRepo: "https://github.com/sclorg/nodejs-ex.git"
Scale Application
# Scale deployment to 3 replicas
oc_scale with name: "my-app", replicas: 3
Patch Resource
# Update deployment labels
oc_patch with resourceType: "deployment", name: "my-app",
patch: '{"metadata":{"labels":{"environment":"production"}}}'
Troubleshoot Issues
# Get pod troubleshooting guidance
Use prompt: troubleshoot-openshift-prompt
Arguments: issueType: "pod", resourceName: "my-app-12345", namespace: "my-project"
# Get deployment troubleshooting guidance
Use prompt: troubleshoot-openshift-prompt
Arguments: issueType: "deployment", resourceName: "my-app", namespace: "my-project"
# Get general cluster troubleshooting guidance
Use prompt: troubleshoot-openshift-prompt
Arguments: issueType: "cluster", symptoms: "nodes not ready"
Development
# Setup
npm install
# Build
npm run build
# Test
npm test
# Start (STDIO)
npm start
# Start (HTTP)
npm run start:http
# Development mode
npm run dev
Transport Modes
STDIO (Default)
- Direct MCP client integration
- Lower latency
- Recommended for local development
HTTP/SSE
- Remote access capability
- Web integration friendly
- Container deployment ready
Architecture
src/
├── index.ts # Main server entry point
├── tools/ # Tool implementations
├── resources/ # MCP resources
├── prompts/ # Interactive prompts
├── sampling/ # Log sampling and analysis
├── models/ # Zod validation schemas
└── utils/ # OpenShift CLI wrapper
Security
Authentication Security
- Token Authentication: Preferred method for automation and production use
- Password Authentication: Available but token authentication is recommended
- HTTPS Enforcement: All cluster connections must use HTTPS
- URL Validation: Server URLs validated to prevent SSRF attacks
- Private IP Blocking: Prevents connections to internal/metadata services
Operational Security
- RBAC Compliance: Respects OpenShift RBAC permissions
- No Credential Storage: Credentials are not stored or transmitted by the server
- User Permissions: Executes with the same permissions as the authenticated user
- Input Validation: Comprehensive validation of all inputs and parameters
- Secure Defaults: Conservative security settings by default
Best Practices
- Use Service Account Tokens: For automation and CI/CD pipelines
- Regular Token Rotation: Rotate authentication tokens regularly
- TLS Certificate Validation: Always validate TLS certificates in production
- Least Privilege: Use accounts with minimal required permissions
- Session Management: Use
oc logoutto clear credentials when done
License
MIT License - see LICENSE file for details.
OpenShift MCP Fragen
Wie füge ich OpenShift MCP zu Claude Code hinzu?
Führe claude mcp add mcp-server-openshift -- npx -y mcp-server-openshift in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich OpenShift MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet OpenShift MCP?
Er stellt 13 Tools bereit, darunter oc_login, oc_api_resources, oc_explain, oc_get, oc_create.
Wie kann ich eine Anwendung mit diesem Server deployen?
Du kannst das oc_new_app Tool nutzen, um Anwendungen direkt aus Git-Repositories mittels S2I-Builds zu deployen.
Was sind die Voraussetzungen für den Betrieb des OpenShift MCP server?
Du benötigst Node.js 20 oder höher, die installierte und konfigurierte OpenShift CLI (oc) sowie Zugriff auf einen OpenShift-Cluster.
Wie wird die Authentifizierung durch den Server gehandhabt?
Der Server stellt ein oc_login Tool bereit, das sicheres Login via Tokens oder Benutzername und Passwort unterstützt.