Kubernetes Troubleshoot

Name: Kubernetes Troubleshoot
Author: NanaGyamfiPrempeh30

Community

MCP server by NanaGyamfiPrempeh30 · updated 2 months ago · ★ 0

Score 27

Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes. Kubernetes Troubleshoot is a community project by NanaGyamfiPrempeh30, not verified by a company domain.

Install Add to Cursor Add to VS Code GitHub Website

Yours? Claim it

Works withClaude Code Claude Desktop Cursor Codex Gemini CLI VS Code Windsurf Antigravity CLI

Install Kubernetes Troubleshoot

Built from the published package, never by AI

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

Run in your terminal. Add --scope user to use it in every project.

Step-by-step: install Kubernetes Troubleshoot in Claude Code

{
  "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": "YOUR_KUBECONFIG",
        "ALLOWED_NAMESPACES": "YOUR_ALLOWED_NAMESPACES"
      }
    }
  }
}

Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.

Step-by-step: install Kubernetes Troubleshoot in Claude Desktop

{
  "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": "YOUR_KUBECONFIG",
        "ALLOWED_NAMESPACES": "YOUR_ALLOWED_NAMESPACES"
      }
    }
  }
}

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).

Step-by-step: install Kubernetes Troubleshoot in Cursor

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

Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".

Step-by-step: install Kubernetes Troubleshoot in VS Code

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

Step-by-step: install Kubernetes Troubleshoot in Codex

{
  "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": "YOUR_KUBECONFIG",
        "ALLOWED_NAMESPACES": "YOUR_ALLOWED_NAMESPACES"
      }
    }
  }
}

Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).

Step-by-step: install Kubernetes Troubleshoot in Antigravity CLI

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

Gemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.

Step-by-step: install Kubernetes Troubleshoot in Gemini CLI

MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the kubernetes-troubleshoot block.

Maintenance

Last commit 60 days ago

Licence

MIT: permissive, fine for commercial use

Quality

Clear description, published package or server URL, original repository

Security

Not checked yet. What we check

What you need

Setting	Needed	What it is
`KUBECONFIG`Environment variable	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 a Default: `/kubeconfig`
`ALLOWED_NAMESPACES`Environment variable	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 b
`LOG_LEVEL`Environment variable	Optional	DEBUG, INFO, WARNING or ERROR. All logging goes to stderr; stdout carries the JSON-RPC stream exclusively. Default: `INFO`
`API_TIMEOUT_SECONDS`Environment variable	Optional	Kubernetes API request timeout. Must be a positive integer. Default: `30`
`MAX_LOG_LINES`Environment variable	Optional	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. Default: `200`

From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.

Weekly newsletter

Like Kubernetes Troubleshoot? Get the best new MCP servers every week

The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.

Alternatives to Kubernetes Troubleshoot

All alternatives →

Azure MCP Server microsoft

100

All Azure MCP tools to create a seamless connection between AI agents and Azure services.

AAA Local 69k/wk

Omnara omnara-ai

Deploy durable AI agents with Omnara, an open-source managed-agent platform.

AAA Remote 2.9k

mcp cloudflare

Cloudflare MCP servers

AAB Remote 4.4k

Superlog superloglabs

Open-source agent that observes and fixes your application. Query logs, traces, metrics, incidents.

AAA Remote 1.5k

Corsair Dev MCP corsairdev

MCP server and framework adapters for Corsair. Expose 200+ integrations to any agent framework (Mastra, LangChain, LlamaIndex, OpenAI, Vercel AI, Claude) as tools.

AAA Local 15k

Evmole cdump

Analyzes deployed EVM bytecode: extracts function selectors and CBOR metadata; infers argument types, state mutability, storage layouts, and control flow.

AAB Local 410k/wk

Kubernetes Troubleshoot vs Azure MCP Server Kubernetes Troubleshoot vs Omnara Kubernetes Troubleshoot vs mcp

Kubernetes Troubleshoot: common questions

How do I install Kubernetes Troubleshoot?

In Claude Code run claude mcp add kubernetes-troubleshoot -e KUBECONFIG=YOUR_KUBECONFIG -e ALLOWED_NAMESPACES=YOUR_ALLOWED_NAMESPACES -- docker run -i --rm -e KUBECONFIG -e ALLOWED_NAMESPACES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.

Is Kubernetes Troubleshoot the official server?

Kubernetes Troubleshoot is a community project by NanaGyamfiPrempeh30, not verified by a company domain.

Is Kubernetes Troubleshoot free?

The code is published under the MIT licence. The service it connects to may have its own pricing.

Is Kubernetes Troubleshoot safe to use?

It scores 27 of 100. Grades: maintenance B, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.

What are alternatives to Kubernetes Troubleshoot?

Similar MCP servers: Azure MCP Server, Omnara, mcp, Superlog.

Does Kubernetes Troubleshoot work with ChatGPT?

Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.