← Index

Kubernetes Troubleshoot

io.github.NanaGyamfiPrempeh30/k8s-troubleshoot-mcpv1.0.0Kubernetes

Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes.

The current version, v1.0.0, was published to the official MCP registry on 2026-08-24. It is distributed as the Docker image docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0, filed under Kubernetes by this index, and declares 5 environment variables. Removals and unreachable sources are measured across every server this index tracks, contract drift across the servers that answer in consecutive snapshots; the index's current counts put this record in context.

In-path gate · all MCP tools

Using Kubernetes Troubleshoot in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

uv tool install mcpindex-gate && mcpindex-config-wire
Auditable install path →Watch it hold a drift →
Trust verdict · v1 advisory · method
NOT YET SCREENEDno verdict on file

Verdict not yet evaluated for this tool. The semantic screen takes adversarial cases first; coverage rolls out as the corpus expands (15/150 labels to graduation). The deterministic conformance probe is built but has not yet run on the public corpus, so a recorded verdict here is REVIEW or UNVERIFIED, never a clearing ALLOW. Until a verdict is recorded, an agent should treat this tool as not-yet-cleared and fall back to its own checks. Method: the eval, four-state verdict, honest limits.

Own this server? Screen its description →

That verdict was true at screening time (snapshot 2026-08-24).

Contracts can change after screening, with no version bump. The gate pins Kubernetes Troubleshoot’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.

See your first HOLD in 2 minutes →

Related: how to trust an MCP server · screen before install · silent contract drift

Environment variables
KUBECONFIG
required

Path to the kubeconfig inside the container. Must match the mount destination. There is no fallback to ~/.kube/config and no in-cluster config: a missing, unreadable or malformed file is a startup failure rather than a silent downgrade to an ambient credential.

ALLOWED_NAMESPACES
required

Comma-separated namespaces the server may read, e.g. staging,production. Wildcards (* and all) are rejected at startup, and kube-system and kube-public are stripped even if listed. This is defense-in-depth, not the security boundary — the boundary is the ServiceAccount's RBAC bindings.

LOG_LEVEL

DEBUG, INFO, WARNING or ERROR. All logging goes to stderr; stdout carries the JSON-RPC stream exclusively.

API_TIMEOUT_SECONDS

Kubernetes API request timeout. Must be a positive integer.

MAX_LOG_LINES

Maximum log lines any single get_pod_logs call may return. Must be a positive integer; clamped to a hard ceiling of 1000 with a warning.

MCP quality score · maturity, not trust · methodology
freshness
25
completeness
20
installability
25
documentation
15
stability
10
Alternatives in Kubernetes
KSail
io.github.devantler-tech/ksail

SDK for creating, managing, and operating Kubernetes clusters and workloads with ease.

Radar
io.github.skyhook-io/radar

Kubernetes visibility for AI agents: query workloads, events, logs, topology, and Helm releases.

io.github.NotHarshhaa/devops-mcp
io.github.NotHarshhaa/devops-mcp

Unified MCP server for Kubernetes, ArgoCD, Prometheus, PagerDuty, and Loki