Kubernetes Troubleshoot MCP Server
io.github.NanaGyamfiPrempeh30/k8s-troubleshoot-mcp
What this kind of tool is for
- Automate a build, test, or deployment step you repeat by hand.
- Review or refactor code in an existing repository without leaving your agent.
- Bridge an internal service or CLI into the agent toolset.
How to compare servers like this
- Scope of control:
- Repos and CI are hard to undo; prefer tools that ask before anything irreversible.
- Environment fit:
- Match the runtime it expects (Node, Python, a container) to what you actually run.
- Maintenance signal:
- Check the last-commit date — dev tooling that lags upstream breaks first.
- Config surface:
- Prefer tools whose environment-variable or config keys are documented plainly.
This page carries your copy-paste config: pick your MCP client in the install section on this page and use the copy button.
What is the Kubernetes Troubleshoot MCP server?
Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes.
How to install Kubernetes Troubleshoot
Copy-paste configuration for popular MCP clients.
KUBECONFIGrequiredPath 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_NAMESPACESrequiredComma-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_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.
{
"mcpServers": {
"k8s-troubleshoot-mcp": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0",
"--mount",
"type=bind,src={kubeconfig_path},dst=/kubeconfig,readonly"
],
"env": {
"KUBECONFIG": "<YOUR_KUBECONFIG>",
"ALLOWED_NAMESPACES": "<YOUR_ALLOWED_NAMESPACES>",
"LOG_LEVEL": "<YOUR_LOG_LEVEL>",
"API_TIMEOUT_SECONDS": "<YOUR_API_TIMEOUT_SECONDS>",
"MAX_LOG_LINES": "<YOUR_MAX_LOG_LINES>"
}
}
}
}Related MCP servers

mcp-broker
Local MCP broker that exposes one compact entry for many upstream servers.
An MCP server that provides DevOps and DevSecOps context for the project
View repository →
Swagger MCP Bridge
Spring Boot example that exposes SpringDoc OpenAPI operations as safe MCP tools.

Verifiable random decisions, audit sampling, fair selection, and proof verification using QnEvt.

io.github.Nano-Nimbus/locus
Hierarchical markdown memory palace for AI agents — structured palace navigation via MCP tools.

