protogrid
Sign inAdd to your agent

Search / io.github.NanaGyamfiPrempeh30/k8s-troubleshoot-mcp

Kubernetes Troubleshoot

L0· runs locally

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

v1.0.0 · active · repository · website · descriptor JSON · versions

Runs on your machine: something must execute the package.Only local packages are published (npm, PyPI, OCI, …). The registry never executes them, so tools are unknown until you run it.
Quality–not scored
Trust90of 100
Packages1
Tools seen0

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "k8s-troubleshoot-mcp": {
      "command": "docker",
      "args": [
        "--mount",
        "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "-e",
        "LOG_LEVEL",
        "-e",
        "API_TIMEOUT_SECONDS",
        "-e",
        "MAX_LOG_LINES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "env": {
        "KUBECONFIG": "/kubeconfig",
        "ALLOWED_NAMESPACES": "${ALLOWED_NAMESPACES}",
        "LOG_LEVEL": "INFO",
        "API_TIMEOUT_SECONDS": "30",
        "MAX_LOG_LINES": "200"
      }
    }
  }
}
claude mcp add k8s-troubleshoot-mcp -e "KUBECONFIG=/kubeconfig" -e "ALLOWED_NAMESPACES=${ALLOWED_NAMESPACES}" -e "LOG_LEVEL=INFO" -e "API_TIMEOUT_SECONDS=30" -e "MAX_LOG_LINES=200" -- docker --mount "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly" -e KUBECONFIG -e ALLOWED_NAMESPACES -e LOG_LEVEL -e API_TIMEOUT_SECONDS -e MAX_LOG_LINES docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0
[mcp_servers.k8s-troubleshoot-mcp]
command = "docker"
args = ["--mount", "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly", "-e", "KUBECONFIG", "-e", "ALLOWED_NAMESPACES", "-e", "LOG_LEVEL", "-e", "API_TIMEOUT_SECONDS", "-e", "MAX_LOG_LINES", "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"]
env = { "KUBECONFIG" = "/kubeconfig", "ALLOWED_NAMESPACES" = "${ALLOWED_NAMESPACES}", "LOG_LEVEL" = "INFO", "API_TIMEOUT_SECONDS" = "30", "MAX_LOG_LINES" = "200" }

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "k8s-troubleshoot-mcp": {
      "type": "local",
      "command": [
        "docker",
        "--mount",
        "type=bind,src={env:kubeconfig_path},dst=/kubeconfig,readonly",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "-e",
        "LOG_LEVEL",
        "-e",
        "API_TIMEOUT_SECONDS",
        "-e",
        "MAX_LOG_LINES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "enabled": true,
      "environment": {
        "KUBECONFIG": "/kubeconfig",
        "ALLOWED_NAMESPACES": "{env:ALLOWED_NAMESPACES}",
        "LOG_LEVEL": "INFO",
        "API_TIMEOUT_SECONDS": "30",
        "MAX_LOG_LINES": "200"
      }
    }
  }
}
{
  "mcpServers": {
    "k8s-troubleshoot-mcp": {
      "command": "docker",
      "args": [
        "--mount",
        "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "-e",
        "LOG_LEVEL",
        "-e",
        "API_TIMEOUT_SECONDS",
        "-e",
        "MAX_LOG_LINES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "env": {
        "KUBECONFIG": "/kubeconfig",
        "ALLOWED_NAMESPACES": "${ALLOWED_NAMESPACES}",
        "LOG_LEVEL": "INFO",
        "API_TIMEOUT_SECONDS": "30",
        "MAX_LOG_LINES": "200"
      }
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=k8s-troubleshoot-mcp&config=eyJjb21tYW5kIjoiZG9ja2VyIiwiYXJncyI6WyItLW1vdW50IiwidHlwZT1iaW5kLHNyYz0ke2t1YmVjb25maWdfcGF0aH0sZHN0PS9rdWJlY29uZmlnLHJlYWRvbmx5IiwiLWUiLCJLVUJFQ09ORklHIiwiLWUiLCJBTExPV0VEX05BTUVTUEFDRVMiLCItZSIsIkxPR19MRVZFTCIsIi1lIiwiQVBJX1RJTUVPVVRfU0VDT05EUyIsIi1lIiwiTUFYX0xPR19MSU5FUyIsImRvY2tlci5pby95YXdneWFtZmlwcmVtMzIvazhzLXRyb3VibGVzaG9vdC1tY3A6MS4wLjAiXSwiZW52Ijp7IktVQkVDT05GSUciOiIva3ViZWNvbmZpZyIsIkFMTE9XRURfTkFNRVNQQUNFUyI6IiR7QUxMT1dFRF9OQU1FU1BBQ0VTfSIsIkxPR19MRVZFTCI6IklORk8iLCJBUElfVElNRU9VVF9TRUNPTkRTIjoiMzAiLCJNQVhfTE9HX0xJTkVTIjoiMjAwIn19"
}
{
  "servers": {
    "k8s-troubleshoot-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "--mount",
        "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "-e",
        "LOG_LEVEL",
        "-e",
        "API_TIMEOUT_SECONDS",
        "-e",
        "MAX_LOG_LINES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "env": {
        "KUBECONFIG": "/kubeconfig",
        "ALLOWED_NAMESPACES": "${ALLOWED_NAMESPACES}",
        "LOG_LEVEL": "INFO",
        "API_TIMEOUT_SECONDS": "30",
        "MAX_LOG_LINES": "200"
      }
    }
  }
}
{
  "mcpServers": {
    "k8s-troubleshoot-mcp": {
      "command": "docker",
      "args": [
        "--mount",
        "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly",
        "-e",
        "KUBECONFIG",
        "-e",
        "ALLOWED_NAMESPACES",
        "-e",
        "LOG_LEVEL",
        "-e",
        "API_TIMEOUT_SECONDS",
        "-e",
        "MAX_LOG_LINES",
        "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
      ],
      "env": {
        "KUBECONFIG": "/kubeconfig",
        "ALLOWED_NAMESPACES": "${ALLOWED_NAMESPACES}",
        "LOG_LEVEL": "INFO",
        "API_TIMEOUT_SECONDS": "30",
        "MAX_LOG_LINES": "200"
      }
    }
  }
}
extensions:
  "k8s-troubleshoot-mcp":
    enabled: true
    name: "k8s-troubleshoot-mcp"
    type: stdio
    cmd: "docker"
    args:
      - "--mount"
      - "type=bind,src=${kubeconfig_path},dst=/kubeconfig,readonly"
      - "-e"
      - "KUBECONFIG"
      - "-e"
      - "ALLOWED_NAMESPACES"
      - "-e"
      - "LOG_LEVEL"
      - "-e"
      - "API_TIMEOUT_SECONDS"
      - "-e"
      - "MAX_LOG_LINES"
      - "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0"
    envs:
      "KUBECONFIG": "/kubeconfig"
      "ALLOWED_NAMESPACES": "${ALLOWED_NAMESPACES}"
      "LOG_LEVEL": "INFO"
      "API_TIMEOUT_SECONDS": "30"
      "MAX_LOG_LINES": "200"
    timeout: 300

This is a local package: the command runs on your machine.

Quality – / 100not scored

Not scored: fewer than three checks apply, usually because no remote answered a credential-free probe or the server is a local package.

protocoln/a · weight 25
  • n/a
    protocol.modern, protocol.stateless, protocol.transport, protocol.list_ttlno remote answered a protocol handshake (not probed yet, unreachable, or local-only)
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygienen/a · weight 30
  • n/a
    tools.descriptions, tools.description_length, tools.schemas, tools.annotations, tools.directory_hints, tools.token_cost, tools.api_dumptool list unknown (behind auth, not probed, or empty)
stabilityn/a · weight 15
  • n/a
    stability.changes, stability.rug_pulltool list unknown
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

Tool list unknown · checked 2026-10-21 01:38 UTC

Tool changes

No tool definition changes recorded. A server's first observation is its baseline; later probes record what changes.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 90 / 100

provenance90
livenessn/a
freshness85
hygiene95

+repository +namespace-matches-repo +website ~liveness-unmeasured ~updated-57d-ago -unpinned-packages(1)

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

packageregistryversionruntimesecrets
docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0ociunpinneddocker

Tools (0)

No tools observed. Local packages are never executed by the registry.

Schemas: list_tools.

Similar MCP servers

  • mcp-k8s-roL0
    io.github.your-ko/mcp-k8s-ro

    Read-only Kubernetes MCP server: inspect resources, logs, events, and metrics. Secrets are masked.

  • k8scortex-mcpL0
    io.github.apatilgtn/k8scortex-mcp

    Kubernetes MCP server: 75 tools for GKE, AKS, EKS, RBAC, audit logging, GitOps, multi-cluster.

  • KubeStellar MCPL0
    io.github.kubestellar/kubestellar-mcp

    AI-powered Kubernetes diagnostics, RBAC analysis, security checks, and app deployment via MCP

  • ContainerR0quality 91
    com.googleapis.container/mcp

    Provides read access to your GKE and Kubernetes resources.

  • K8s MCP Server (Go)L0
    io.github.kaneg/k8s-mcp-go

    Safe Kubernetes access for AI agents via MCP. Read-only by default, with explicit permission modes.

  • KubesharkL0
    io.github.kubeshark/mcp

    Real-time Kubernetes network traffic visibility and API analysis for HTTP, gRPC, Redis, Kafka, DNS.

Official server.json
{
  "name": "io.github.NanaGyamfiPrempeh30/k8s-troubleshoot-mcp",
  "title": "Kubernetes Troubleshoot",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "version": "1.0.0",
  "packages": [
    {
      "transport": {
        "type": "stdio"
      },
      "identifier": "docker.io/yawgyamfiprem32/k8s-troubleshoot-mcp:1.0.0",
      "runtimeHint": "docker",
      "registryType": "oci",
      "runtimeArguments": [
        {
          "name": "--mount",
          "type": "named",
          "value": "type=bind,src={kubeconfig_path},dst=/kubeconfig,readonly",
          "variables": {
            "kubeconfig_path": {
              "format": "filepath",
              "isRequired": true,
              "description": "Absolute path on the host to a kubeconfig scoped to the diagnostic ServiceAccount. Generate it with scripts/generate-kubeconfig.sh — do not mount an admin kubeconfig. The file must be readable by UID 10001, which the container runs as."
            }
          },
          "isRequired": true,
          "description": "Mount the kubeconfig read-only. This server performs no writes of any kind, so a writable mount would grant privilege it has no use for."
        }
      ],
      "environmentVariables": [
        {
          "name": "KUBECONFIG",
          "default": "/kubeconfig",
          "isRequired": true,
          "description": "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."
        },
        {
          "name": "ALLOWED_NAMESPACES",
          "format": "string",
          "isRequired": true,
          "description": "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."
        },
        {
          "name": "LOG_LEVEL",
          "default": "INFO",
          "description": "DEBUG, INFO, WARNING or ERROR. All logging goes to stderr; stdout carries the JSON-RPC stream exclusively."
        },
        {
          "name": "API_TIMEOUT_SECONDS",
          "default": "30",
          "description": "Kubernetes API request timeout. Must be a positive integer."
        },
        {
          "name": "MAX_LOG_LINES",
          "default": "200",
          "description": "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."
        }
      ]
    }
  ],
  "repository": {
    "url": "https://github.com/NanaGyamfiPrempeh30/k8s-troubleshoot-mcp",
    "source": "github"
  },
  "websiteUrl": "https://github.com/NanaGyamfiPrempeh30/k8s-troubleshoot-mcp#readme",
  "description": "Read-only Kubernetes diagnostics: pods, logs, events, workloads, services, PVCs and nodes."
}