Kubernetes Troubleshoot
Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes.
- Pricing
- Open source
- Runs
- Locally
- Version
- 1.0.0
- Listing updated
- 4 days ago
About Kubernetes Troubleshoot
Kubernetes Troubleshoot is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
Install
Run in a terminal
claude mcp add k8s-troubleshoot-mcp --env KUBECONFIG='<KUBECONFIG>' --env ALLOWED_NAMESPACES='<ALLOWED_NAMESPACES>' -- docker run -i --rm -e KUBECONFIG -e ALLOWED_NAMESPACES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0Add to claude_desktop_config.json
{
"mcpServers": {
"k8s-troubleshoot-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KUBECONFIG",
"-e",
"ALLOWED_NAMESPACES",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"ALLOWED_NAMESPACES": "<ALLOWED_NAMESPACES>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"k8s-troubleshoot-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KUBECONFIG",
"-e",
"ALLOWED_NAMESPACES",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"ALLOWED_NAMESPACES": "<ALLOWED_NAMESPACES>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"k8s-troubleshoot-mcp": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KUBECONFIG",
"-e",
"ALLOWED_NAMESPACES",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"ALLOWED_NAMESPACES": "<ALLOWED_NAMESPACES>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"k8s-troubleshoot-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KUBECONFIG",
"-e",
"ALLOWED_NAMESPACES",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"ALLOWED_NAMESPACES": "<ALLOWED_NAMESPACES>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"k8s-troubleshoot-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"KUBECONFIG",
"-e",
"ALLOWED_NAMESPACES",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
],
"env": {
"KUBECONFIG": "<KUBECONFIG>",
"ALLOWED_NAMESPACES": "<ALLOWED_NAMESPACES>"
}
}
}
}Configuration
KUBECONFIGPath 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.RequiredALLOWED_NAMESPACESComma-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.RequiredLOG_LEVELDEBUG, INFO, WARNING or ERROR. All logging goes to stderr; stdout carries the JSON-RPC stream exclusively.API_TIMEOUT_SECONDSKubernetes API request timeout. Must be a positive integer.MAX_LOG_LINESMaximum 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.
Pricing
Open source
Kubernetes Troubleshoot FAQ
Is Kubernetes Troubleshoot free?
Yes. Kubernetes Troubleshoot is open source, so you can use and self-host it for free.
How do I add Kubernetes Troubleshoot to Claude Code?
Run this command in your terminal: claude mcp add k8s-troubleshoot-mcp --env KUBECONFIG='<KUBECONFIG>' --env ALLOWED_NAMESPACES='<ALLOWED_NAMESPACES>' -- docker run -i --rm -e KUBECONFIG -e ALLOWED_NAMESPACES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0
What are the best alternatives to Kubernetes Troubleshoot?
The closest alternatives to Kubernetes Troubleshoot are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to Kubernetes Troubleshoot

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ouroboros
MCP serverSpec-first layer that pins requirements and verifies results of AI coding agent work
Runs locally- Open source
- 6.4K GitHub stars
- Developer tools