kubectl-mcp-server

Install

npx skillfoxx add mcp/kubectl-mcp-server

claude mcp add --transport stdio kubernetes -- npx -y kubectl-mcp-server

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

code --add-mcp '{"name":"kubernetes","type":"stdio","command":"npx","args":["-y","kubectl-mcp-server"]}'

{
  "servers": {
    "kubernetes": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

codex mcp add kubernetes -- npx -y kubectl-mcp-server

[mcp_servers.kubernetes]
command = "npx"
args = ["-y", "kubectl-mcp-server"]

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcp": {
    "kubernetes": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "context_servers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": [
        "-y",
        "kubectl-mcp-server"
      ]
    }
  }
}

npx -y kubectl-mcp-server

This is third-party code. Review the repository files before installing.

What it does

The server connects Kubernetes to an agent through your existing kubeconfig. The agent sees pods, deployments and namespaces, explains why a pod is crashing, works through network problems and creates or scales resources. It installs via npx, pip or docker and fits Claude Desktop, Cursor, Windsurf and other MCP clients. It supports the stdio transport for local use and sse to run as a networked service. The repository also ships skill sets on Kubernetes topics for agents that read them.

Who it is for. For devops engineers and developers who operate Kubernetes clusters and want to drive them from an agent.

Example request

Show all pods in the kube-system namespace and explain why nginx-deployment is crashing

Limitations

It works against the cluster and permissions set in your kubeconfig, so its scope equals that context's rights. The pip install needs Python 3.9 or newer, the npx path needs Node.js. The server runs real kubectl operations, including mutating ones, so the risk of a mistake is on the user.

How to disable. Remove the kubernetes entry from your MCP client config. If installed via pip or npm, uninstall the kubectl-mcp-server package.

MCP

Transport

stdio, sse

Authentication

not required

Security check

• Runs real kubectl operations against the cluster, including mutating ones
• Its scope equals the kubeconfig permissions
• An agent mistake can affect a live cluster

README in short

The README leads with an npx quick start, plus pip installs and docker images from Docker Hub and GHCR. It documents configs for Claude Desktop, Cursor, Windsurf and running via python -m kubectl_mcp_tool.mcp_server with KUBECONFIG. It includes example prompts for troubleshooting, deployments and networking, plus the CLI commands info, tools and call. The project is listed in the CNCF Landscape and is MIT licensed.

Related