mcp-server-kubernetes

MCP Server that can connect to a Kubernetes cluster and manage it.

https://github.com/user-attachments/assets/f25f8f4e-4d04-479b-9ae0-5dac452dd2ed

Usage with Claude Desktop

Clone the repo, install the dependencies, and build the dist folder (can use node or bun if you want to build locally):

bun run build

To use this server with the Claude Desktop app, add the following configuration to the "mcpServers" section of your claude_desktop_config.json:

Note that you can use node or bun to run the server. Tests will currently only run properly with bun at the moment though.

{
  "mcpServers": {
    "kubernetes": {
      "command": "bun",
      "args": ["/your/path/to/mcp-server-kubernetes/dist/index.js"]
    }
  }
}

The server will automatically connect to your current kubectl context. Make sure you have:

1. kubectl installed and in your PATH
2. A valid kubeconfig file with contexts configured
3. Access to a Kubernetes cluster configured for kubectl (e.g. minikube, Rancher Desktop, GKE, etc.)

You can verify your connection by asking Claude to list your pods or create a test deployment.

Features

• [x] Connect to a Kubernetes cluster
• [x] List all pods
• [x] List all services
• [x] List all deployments
• [x] Create a pod
• [x] Delete a pod
• [x] List all namespaces
• [] Port forward to a pod
• [] Get logs from a pod for debugging
• [] Choose namespace for next commands (memory)
• [] Support Helm for installing charts

How to run tests locally

git clone https://github.com/Flux159/mcp-server-kubernetes.git
cd mcp-server-kubernetes
bun install
bun run test

Not planned

Authentication / adding clusters to kubectx.