mcp-kubernetes

Ein Model Context Protocol-Server für Kubernetes. Er ermöglicht es einem MCP-fähigen Client (Claude Desktop, Claude Code, usw.), Kubernetes-Cluster über mehrere Kontexte hinweg zu inspizieren und zu verwalten – wobei das Verhalten vollständig über Flags gesteuert wird.

Das Designziel ist standardmäßig sicher: Der Server startet mit reinem Lesezugriff, kann auf eine Zulassungsliste von Namespaces und Kontexten eingeschränkt werden, schützt System-Namespaces vor Mutationen und gibt die gefährlichen Operationen (delete, apply, exec) nur nach explizitem Opt-in frei.

Funktionen

• Multi-Cluster – jedes Tool akzeptiert einen optionalen context; eine Zulassungsliste definiert, welche Kontexte verwendet werden können.

• Zugriffsmodi – read-only → read-write → admin, gestaffelt, sodass ein Modus nie Tools oberhalb seiner Stufe verfügbar macht.

• Sicherheits-Flags – Namespace-Zulassungsliste, geschützte Namespaces, Kontext-Zulassungsliste sowie unabhängige Opt-ins für delete / apply / exec, Dry-Run und JSON-Audit-Logging (siehe unten).

• Standard-Authentifizierung – verwendet die kube-config (oder ein In-Cluster-Servicekonto). Der Server speichert keinerlei Zugangsdaten.

Related MCP server: k8s-mcp-go

Sicherheitsmodell

Die Ebenen sind unabhängig – z. B. kann der admin-Modus bei allen drei Opt-ins auf false Deployments neu starten und skalieren, aber weder Ressourcen löschen noch exec in Pods ausführen.

Werkzeuge

Lesen (read-only+): list_contexts, list_namespaces, list_pods, get_pod, get_pod_logs, list_deployments, list_services, list_nodes, list_events, get_resource

Schreiben (read-write+): scale_deployment, restart_deployment, set_deployment_image, create_namespace, apply_manifest (benötigt K8S_ALLOW_APPLY)

Admin (admin): delete_resource (benötigt K8S_ALLOW_DELETE), exec_in_pod (benötigt K8S_ALLOW_EXEC)

Verwendung mit Ihrem MCP-Client

Funktioniert mit Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code (Copilot) und jedem anderen MCP-Client – siehe docs/CLIENTS.md für die Einrichtung des jeweiligen Clients.

Installation

npm install
npm run build

Ausführen mit Claude Desktop / Claude Code

Fügen Sie Ihrer MCP-Client-Konfiguration Folgendes hinzu:

{
  "mcpServers": {
    "kubernetes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-kubernetes/dist/index.js"],
      "env": {
        "KUBECONFIG_PATH": "/Users/you/.kube/config",
        "K8S_MODE": "read-only",
        "K8S_CONTEXT_ALLOWLIST": "staging",
        "K8S_NAMESPACE_ALLOWLIST": "app,web"
      }
    }
  }
}

Setzen Sie K8S_MODE auf read-write, um Skalierungen oder Neustarts zu ermöglichen, und nur auf admin (plus das entsprechende K8S_ALLOW_*-Flag), wenn Sie Löschungen oder exec zulassen möchten.

Entwicklung

npm run dev        # watch mode
npm test           # unit tests for the security policy
npm run typecheck

Veröffentlichung

Der Server enthält eine server.json für die offizielle MCP-Registry und ein mcpName zur npm-Besitzüprüfung. Siehe PUBLISHING.md für die Veröffentlichung auf npm und die Listung in der MCP-Registry, bei Smithery, Glama, Cursor und PulseMCP.

Lizenz

MIT