Kubernetes Troubleshoot MCP Server: Install & Setup

Install Kubernetes Troubleshoot in Claude Code

Claude Code

claude mcp add kubernetes-troubleshoot -e KUBECONFIG=... -e ALLOWED_NAMESPACES=... -- docker run -i --rm -e KUBECONFIG -e ALLOWED_NAMESPACES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0

mcp.json (Claude Desktop, Cursor, VS Code, Windsurf)

{
  "mcpServers": {
    "kubernetes-troubleshoot": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "env": {
        "KUBECONFIG": "...",
        "ALLOWED_NAMESPACES": "..."
      }
    }
  }
}

Replace each ... with your own value.

Frequently asked questions

What does the Kubernetes Troubleshoot MCP server do?

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

Is the Kubernetes Troubleshoot MCP server free?

Yes, most likely. Open source and no paid account or API key is mentioned in the listing. Check the provider for current pricing.

Does Kubernetes Troubleshoot run locally or remotely?

Local. Runs on your machine (stdio). You install it with npx, uvx, Docker or from source.

How do I add Kubernetes Troubleshoot to Claude Code?

Run: claude mcp add kubernetes-troubleshoot -e KUBECONFIG=... -e ALLOWED_NAMESPACES=... -- docker run -i --rm -e KUBECONFIG -e ALLOWED_NAMESPACES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0

More cloud platforms MCP servers

View all

Lokka

jozrahq/lokka

Query and manage Microsoft Graph and Azure Resource Manager APIs from MCP clients.

LocalFree

Kubernetes Ephemeral Job

inhuman/mcp-k8s-ephemeral-job

Runs a command in a throwaway Kubernetes pod and returns exit code, output and artifacts.

LocalFree

meek_consolidation_absorption_mcp

CSOAI-ORG/meek-consolidation-absorption-mcp

MEEK Consolidation + Absorption MCP — the CSOAI hive GCP VM consolidation. MIT-licensed.

LocalFree

KubeDrive

aleksskoz/kubedrive

Your Kubernetes clusters for AI agents through the KubeDrive desktop app, without a kubeconfig.

LocalAccount needed

meek_defoneos_cdn_edge_mcp

CSOAI-ORG/meek-defoneos-cdn-edge-mcp

MEEK DEFONEOS CDN Edge MCP — Cloudflare + Vercel Edge + multi-region CDN. MIT-licensed.

LocalFree

kube-noob

aashishmahajan/kube-noob

Kubernetes, OpenShift, ROSA HCP, Helm and RHACS audit, debugging and cited docs. No AI inside.

LocalFree