rea
Reverse engineer anything with agents, from app behavior down to native binaries.
Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes.
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Reverse engineer anything with agents, from app behavior down to native binaries.
A single CLAUDE.md file to improve Claude Code behavior, derived from Andrej Karpathy's observations on LLM coding pitfalls.
Turn any codebase, with its docs, SQL schemas, configs, and PDFs, into a queryable knowledge graph. A /graphify skill for Claude Code, Cursor, Codex, and Gemini CLI: local deterministic AST parsing, every edge explained, no vector store.
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 0/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 7/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 0/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 7/100 |
Qualität: 3/3 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
3/3 Prüfungen bestanden · Läuft auf deinem Computer
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude, aber erst etwas vorbereiten
2 Einstellung(en) auszufüllen (KUBECONFIG, ALLOWED_NAMESPACES) · Installiere zuerst Docker auf deinem Computer (nur einmal) · Nur in der Claude-App für den Computer (Windows oder Mac), nicht im Web oder auf dem Handy
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
KUBECONFIG Pfad zur kubeconfig-Datei im Container. Muss mit dem Mount-Ziel übereinstimmen. Es gibt keinen Rückfall auf /.kube/config und keine In-Cluster-Konfiguration: Fehlt die Datei, ist sie nicht lesbar oder fehlerhaft, schlägt der Start fehl. ALLOWED_NAMESPACES Durch Kommas getrennte Namespaces, die der Server lesen darf, z. B. staging,production. Wildcards ( und all) werden beim Start abgelehnt, und kube-system sowie kube-public werden auch dann entfernt, wenn sie aufgelistet sind. Dies ist Verteidigung in der Tiefe. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
SettingsDeveloperEdit Config
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Nutze Kubernetes Troubleshoot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es Kubernetes Troubleshoot nutzt, oder ein Werkzeug von Kubernetes Troubleshoot in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LOG_LEVEL DEBUG, INFO, WARNING oder ERROR. Alle Logs gehen an stderr; stdout ist ausschließlich für den JSON-RPC-Stream bestimmt. API_TIMEOUT_SECONDS Zeitlimit für Kubernetes-API-Anfragen. Muss eine positive ganze Zahl sein. MAX_LOG_LINES Maximale Anzahl von Protokollzeilen, die ein einzelner get_pod_logs-Aufruf zurückgeben darf. Muss eine positive Ganzzahl sein; wird mit einer Warnung auf die feste Obergrenze von 1000 begrenzt. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
ChatGPT kann Kubernetes Troubleshoot noch nicht verbinden
Kubernetes Troubleshoot läuft auf deinem Computer, aber ChatGPT verbindet nur Server, die im Web laufen
A · Eine App nutzen, die Kubernetes Troubleshoot verbinden kann
B · Andere in Entwicklertools, die mit ChatGPT funktionieren
Aus den meistgenutzten derselben Kategorie, nur solche, die per Adresse ohne Schlüssel verbinden
Klappt mit Claude Code, aber erst etwas vorbereiten
2 Einstellung(en) auszufüllen (KUBECONFIG, ALLOWED_NAMESPACES) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
KUBECONFIG Pfad zur kubeconfig-Datei im Container. Muss mit dem Mount-Ziel übereinstimmen. Es gibt keinen Rückfall auf /.kube/config und keine In-Cluster-Konfiguration: Fehlt die Datei, ist sie nicht lesbar oder fehlerhaft, schlägt der Start fehl. ALLOWED_NAMESPACES Durch Kommas getrennte Namespaces, die der Server lesen darf, z. B. staging,production. Wildcards ( und all) werden beim Start abgelehnt, und kube-system sowie kube-public werden auch dann entfernt, wenn sie aufgelistet sind. Dies ist Verteidigung in der Tiefe. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Kubernetes Troubleshoot sollte in der Liste als verbunden erscheinen
Nutze Kubernetes Troubleshoot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es Kubernetes Troubleshoot nutzt, oder ein Werkzeug von Kubernetes Troubleshoot in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LOG_LEVEL DEBUG, INFO, WARNING oder ERROR. Alle Logs gehen an stderr; stdout ist ausschließlich für den JSON-RPC-Stream bestimmt. API_TIMEOUT_SECONDS Zeitlimit für Kubernetes-API-Anfragen. Muss eine positive ganze Zahl sein. MAX_LOG_LINES Maximale Anzahl von Protokollzeilen, die ein einzelner get_pod_logs-Aufruf zurückgeben darf. Muss eine positive Ganzzahl sein; wird mit einer Warnung auf die feste Obergrenze von 1000 begrenzt. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor, aber erst etwas vorbereiten
2 Einstellung(en) auszufüllen (KUBECONFIG, ALLOWED_NAMESPACES) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
KUBECONFIG Pfad zur kubeconfig-Datei im Container. Muss mit dem Mount-Ziel übereinstimmen. Es gibt keinen Rückfall auf /.kube/config und keine In-Cluster-Konfiguration: Fehlt die Datei, ist sie nicht lesbar oder fehlerhaft, schlägt der Start fehl. ALLOWED_NAMESPACES Durch Kommas getrennte Namespaces, die der Server lesen darf, z. B. staging,production. Wildcards ( und all) werden beim Start abgelehnt, und kube-system sowie kube-public werden auch dann entfernt, wenn sie aufgelistet sind. Dies ist Verteidigung in der Tiefe. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
In den Einstellungen von Kubernetes Troubleshoot ist KUBECONFIG, ALLOWED_NAMESPACES leer; trag deinen Schlüssel ein und speichere
Nutze Kubernetes Troubleshoot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es Kubernetes Troubleshoot nutzt, oder ein Werkzeug von Kubernetes Troubleshoot in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LOG_LEVEL DEBUG, INFO, WARNING oder ERROR. Alle Logs gehen an stderr; stdout ist ausschließlich für den JSON-RPC-Stream bestimmt. API_TIMEOUT_SECONDS Zeitlimit für Kubernetes-API-Anfragen. Muss eine positive ganze Zahl sein. MAX_LOG_LINES Maximale Anzahl von Protokollzeilen, die ein einzelner get_pod_logs-Aufruf zurückgeben darf. Muss eine positive Ganzzahl sein; wird mit einer Warnung auf die feste Obergrenze von 1000 begrenzt. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code, aber erst etwas vorbereiten
2 Einstellung(en) auszufüllen (KUBECONFIG, ALLOWED_NAMESPACES) · Installiere zuerst Docker auf deinem Computer (nur einmal)
Schon installiert? Zuerst prüfen · Öffne das Terminal, gib diesen Befehl ein und drücke Enter
docker --versionMac: ⌘ + Leertaste drücken, Terminal eingeben, Enter
Windows: Start öffnen, Windows PowerShell eingeben, dann Öffnen
Noch nicht installiert: Docker Desktop installieren: auf dem Mac Docker.dmg öffnen und das Symbol in „Programme“ ziehen (Apple silicon oder Intel passend zum Mac wählen) · unter Windows Docker Desktop Installer.exe doppelklicken · danach die App Docker Desktop öffnen und laufen lassen. Kein curl-Befehl nötig
Download-Seite von Docker öffnen ↗
Danach das Terminal schließen, neu öffnen und denselben Befehl erneut ausführen. Es muss eine Versionsnummer erscheinen: docker --version
Einmal installieren, gilt für alles, was Docker braucht
Das sind Programmeinstellungen, keine Schlüssel. Keine Registrierung nötig; wie vom Autor beschrieben ausfüllen.
KUBECONFIG Pfad zur kubeconfig-Datei im Container. Muss mit dem Mount-Ziel übereinstimmen. Es gibt keinen Rückfall auf /.kube/config und keine In-Cluster-Konfiguration: Fehlt die Datei, ist sie nicht lesbar oder fehlerhaft, schlägt der Start fehl. ALLOWED_NAMESPACES Durch Kommas getrennte Namespaces, die der Server lesen darf, z. B. staging,production. Wildcards ( und all) werden beim Start abgelehnt, und kube-system sowie kube-public werden auch dann entfernt, wenn sie aufgelistet sind. Dies ist Verteidigung in der Tiefe. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
In den Einstellungen von Kubernetes Troubleshoot ist KUBECONFIG, ALLOWED_NAMESPACES leer; trag deinen Schlüssel ein und speichere
Nutze Kubernetes Troubleshoot und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es Kubernetes Troubleshoot nutzt, oder ein Werkzeug von Kubernetes Troubleshoot in der Antwort zeigt, bist du verbunden
Der Befehl oben funktioniert auch ohne diese Werte. Füge sie nur hinzu, wenn du etwas ändern willst, nach der Beschreibung des Autors.
LOG_LEVEL DEBUG, INFO, WARNING oder ERROR. Alle Logs gehen an stderr; stdout ist ausschließlich für den JSON-RPC-Stream bestimmt. API_TIMEOUT_SECONDS Zeitlimit für Kubernetes-API-Anfragen. Muss eine positive ganze Zahl sein. MAX_LOG_LINES Maximale Anzahl von Protokollzeilen, die ein einzelner get_pod_logs-Aufruf zurückgeben darf. Muss eine positive Ganzzahl sein; wird mit einer Warnung auf die feste Obergrenze von 1000 begrenzt. Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
JSON-Einstellungen stehen unten unter „Für Entwickler“
Claude Code
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Claude Desktop (claude_desktop_config.json)
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
Cursor (~/.cursor/mcp.json)
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
VS Code (mcp.json)
Befehle werden geprüft · Kopier-Buttons erscheinen, sobald sie bestanden sind
KUBECONFIG erforderlich envALLOWED_NAMESPACES erforderlich envLOG_LEVEL envAPI_TIMEOUT_SECONDS envMAX_LOG_LINES envBeschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
oci: docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026
Der Registry-Name wurde mit dem GitHub-Konto NanaGyamfiPrempeh30 bestätigt, dem das Repo gehört
Code zuletzt geändert: vor 3 Monaten
Nutzt MIT
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Nicht geprüft: nur npm- und PyPI-Pakete mit Version lassen sich prüfen
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/nanagyamfiprempeh30-k8s-troubleshoot-mcp)Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Noch keine Bewertungen
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Er hat 3 von 3 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Das GitHub-Repo wurde zuletzt vor 3 Monaten geändert, und die neueste Version (1.0.0) kam vor 3 Monaten in die Registry.
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.
In derselben Kategorie: GitDiagram, Appllama, Cloudflare MCP, Omnara, Repowise
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Architecture diagrams, explanations and Mermaid source for public GitHub repositories.
Study screens, flows and paywalls from top-earning iOS apps, then build from what wins.
Cloudflare MCP servers
Deploy durable AI agents with Omnara, an open-source managed-agent platform.
Codebase intelligence for AI coding agents: graph, git history, docs, decisions, code health.
| Dieser Kubernetes Troubleshoot | GitDiagram | Appllama | Cloudflare MCP | Omnara | Repowise | |
|---|---|---|---|---|---|---|
| Läuft wo | Wird auf deinem Rechner installiert | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | In der Cloud oder auf deinem Rechner |
| Braucht Schlüssel | Nein | Nein | Nein | Nein | Nein | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Ja | Nein | Nein |
| Basisprüfungen | 3/3 | 4/4 | 4/4 | 4/4 | 4/4 | 5/5 |
| Lizenz | MIT | MIT | MIT | Apache-2.0 | Apache-2.0 | AGPL-3.0 |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
A read-only MCP (Model Context Protocol) server that lets an AI assistant diagnose a Kubernetes cluster. Ask why a pod is crash-looping instead of running six kubectl commands and correlating the output by hand.
Read-only is a structural property, not a promise. There are no write tools, and the RBAC manifests grant no write verbs. See Security model.
The server exposes 16 diagnostic tools over stdio. Connect it to Claude Desktop, VS Code, or Kiro, and you can ask things like:
checkout pod in staging not ready?"api container"web HPA scaling, and what does its current metric say?"production in the last few minutes?"The assistant calls the tools, the server queries the Kubernetes API with a scoped ServiceAccount token, and every response comes back as a structured dict — including errors, which are never raised as exceptions into the MCP layer.
┌──────────────────┐ stdio (JSON-RPC) ┌──────────────────────────┐
│ MCP Client │◄─────────────────────►│ MCP Server │ │ Claude Desktop │ │ (this project) │ │ VS Code / Kiro │ │ │ └──────────────────┘ │ config.py ─ validate │ │ server.py ─ 16 tools │ │ tools/*.py ─ read+shape│ │ response.py ─ escape + │ │ structure │ └───────────┬──────────────┘ │ HTTPS, explicit │ KUBECONFIG only ┌───────────▼──────────────┐ │ Kubernetes API server │ │ ── RBAC boundary ── │ │ ServiceAccount: │ │ get/list/watch only │ └──────────────────────────┘
Configuration is validated once at startup. If anything is wrong — KUBECONFIG unset, the file unreadable or malformed, ALLOWED_NAMESPACES missing or containing a wildcard — the process writes one line to stderr and exits 1. It never starts in a partially-valid state.
Arguments marked ? are optional.
| Tool | Description | Parameters |
|---|---|---|
get_pod_status | Phase, conditions, container statuses, QoS class and node for a pod | pod_name, namespace |
get_pod_logs | Recent log lines from a pod container. Content is untrusted — see Reading get_pod_logs output | pod_name, namespace, container?, previous?, tail_lines? |
get_pod_events | Recent events for a pod, newest first, with total_available | pod_name, namespace |
list_pods | Pods in a namespace with phase, restart count and readiness | namespace, label_selector? |
get_node_status | Conditions, capacity, allocatable, taints and roles for a node | node_name |
list_nodes | Cluster nodes with readiness, roles, age and kubelet version | none |
get_deployment_status | Replica counts, conditions and rollout strategy | deployment_name, namespace |
list_deployments | Deployments in a namespace with replica counts and availability | namespace |
get_statefulset_status | Replica counts, revisions and update strategy | statefulset_name, namespace |
get_daemonset_status | Scheduling counts and update strategy | daemonset_name, namespace |
get_service | Type, ClusterIP, ports, selector and ready endpoint count | service_name, namespace |
get_endpoints | Ready and not-ready endpoint addresses backing a service | service_name, namespace |
get_pvc_status | Phase, capacity, binding and resize state for a PVC | pvc_name, namespace |
get_hpa_status | Replica bounds, current metrics and conditions for an HPA | hpa_name, namespace |
get_namespace_events | Recent events across a namespace, newest first, with total_available | namespace, limit? |
list_namespaces | The namespaces this server is permitted to read | none |
Every namespaced tool validates its namespace argument before making any API call, so a disallowed namespace produces a structured error and no network request.
No get_secrets, get_configmap, exec_into_pod, port_forward, or any create/update/patch/delete tool. These are excluded from all versions unless a new threat-model review is conducted and documented — they are not backlog items. The reasoning for each is in SECURITY.md.
Full detail is in SECURITY.md. The summary:
Everything this server does in application code is defense-in-depth. The enforcement boundary is the ServiceAccount's RBAC bindings. If the bindings grant more than intended, the application-layer allowlist is all that stands in the way, and it is not a boundary you should rely on.
Provisioning is split by scope so that the cluster-scoped grant is minimal:
| Manifest | Scope | Grants |
|---|---|---|
clusterrole.yaml + clusterrolebinding.yaml | cluster | get/list/watch on nodes and namespaces only |
role.yaml | namespace | get/list/watch on the diagnostic resources |
rolebinding.yaml.template | namespace | binds the Role, one namespace at a time |
Applying the cluster-scoped pair makes no namespace readable. A namespace becomes readable only when a Role *and* a RoleBinding exist in it. A namespace listed in ALLOWED_NAMESPACES but never bound stays unreadable — RBAC wins.
pods/log is granted in its own rule block, never folded into the pods rule, because Kubernetes subresources do not inherit from their parent.
| Layer | What it does | What it is not |
|---|---|---|
| RBAC | Grants read verbs on diagnostic resources in bound namespaces only | — this *is* the boundary |
| Explicit kubeconfig | Reads KUBECONFIG from an exact path; no ~/.kube/config, no in-cluster config, no fallback chain | Not a permission check — it prevents silently picking up an ambient credential |
| Namespace allowlist | Rejects wildcards, strips kube-system/kube-public, validates before every call | Advisory; a bug here is contained by RBAC |
| Output escaping | All cluster-authored free text routed through serialize_log_content | Prevents breaking out of a JSON string; cannot stop a model acting on legible instructions |
| Structured errors | Every failure returns a dict; no exception reaches the MCP layer | — |
Pod logs and event messages are written by workloads in the cluster. A container can print anything, including text shaped like instructions to the model reading it. Escaping keeps injected text inside its JSON string; it cannot stop a model from acting on instructions it reads as data. Treat tool output as untrusted input to whatever consumes it. This residual risk is accepted and documented.
kubectl context with enough permission to create a ServiceAccount, Role, RoleBinding, ClusterRole and ClusterRoleBinding — you need this once, to provision. The server itself never uses your admin credential.scripts/generate-kubeconfig.sh mints a token via the TokenRequest API, not a legacy auto-mounted Secret.curl -LsSf https://astral.sh/uv/install.sh | sh (or use Docker, which needs neither Python nor uv on the host)git clone https://github.com/NanaGyamfiPrempeh30/k8s-troubleshoot-mcp.git
cd k8s-troubleshoot-mcp
uv sync
uv run pytest tests/ -q
scripts/generate-kubeconfig.sh /secure/path/k8s-mcp-kubeconfig.yaml staging production
The first argument is where to write the kubeconfig; the rest are the namespaces the server may read. Pass the same set you intend to put in ALLOWED_NAMESPACES — RBAC is the enforcement boundary, and a namespace bound here but absent from the allowlist (or the reverse) is a mismatch between real permission and configured capability.
The script applies the cluster-scoped manifests together, then applies role.yaml with an explicit -n and renders a RoleBinding per namespace. On success it prints the kubeconfig path to stdout and nothing else; all diagnostics go to stderr. It also asserts after provisioning that kubectl auth can-i get secrets returns no, and aborts if it does not.
Do not run `kubectl apply -f kubernetes/`. It does not fail — it reports
success while creating
role.yamlin the *current* namespace and skipping
rolebinding.yaml.templateentirely, becausekubectl apply -fonly
reads
.yaml/.yml/.json. The result is a server that looks provisioned
and can read nothing. Verified against a v1.35 API server with
--dry-run=server: 5 resources applied, not 6.
The generated kubeconfig is written with umask 077 and chmod 600. Keep it out of the repository — the script warns if the output path is inside a repository and not covered by .gitignore.
KUBECONFIG=/secure/path/k8s-mcp-kubeconfig.yaml \
ALLOWED_NAMESPACES=staging,production \ uv run k8s-troubleshoot-mcp
The server speaks JSON-RPC on stdin/stdout, so it will appear to hang — that is correct. It is waiting for a client.
Add to claude_desktop_config.json (%APPDATA%\Claude\claude_desktop_config.json on Windows, ~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": { "k8s-troubleshoot": { "command": "uv", "args": ["run", "k8s-troubleshoot-mcp"], "cwd": "/path/to/k8s-troubleshoot-mcp", "env": { "KUBECONFIG": "/secure/path/k8s-mcp-kubeconfig.yaml", "ALLOWED_NAMESPACES": "staging,production" } } } }
Restart Claude Desktop fully (quit from the system tray, reopen), then check Settings → Developer → k8s-troubleshoot shows running.
On Windows, if the server shows as disconnected, use a batch file wrapper — Claude Desktop has working-directory issues with direct interpreter invocation:
@echo off
cd /d C:\Users\YourUsername\k8s-troubleshoot-mcp uv run k8s-troubleshoot-mcp
{
"mcpServers": { "k8s-troubleshoot": { "command": "cmd.exe", "args": ["/c", "C:\\Users\\YourUsername\\k8s-troubleshoot-mcp\\run_mcp.bat"], "env": { "KUBECONFIG": "C:\\secure\\path\\k8s-mcp-kubeconfig.yaml", "ALLOWED_NAMESPACES": "staging,production" } } } }
docker build -t k8s-troubleshoot-mcp .
docker run -i --rm \ -v /secure/path/k8s-mcp-kubeconfig.yaml:/kubeconfig:ro \ -e KUBECONFIG=/kubeconfig \ -e ALLOWED_NAMESPACES=staging,production \ k8s-troubleshoot-mcp
-i is required — JSON-RPC travels on stdin/stdout. :ro is not decoration: this server performs no writes of any kind, so a writable mount would grant privilege it has no use for.
The image runs as non-root, UID 10001, and contains no c