what is mcp-server-kubernetes?
MCP Server that connects to a Kubernetes cluster to manage it effectively.
how to use mcp-server-kubernetes?
To use mcp-server-kubernetes, ensure you have kubectl installed and configured. Run the command npx mcp-server-kubernetes
to connect to your Kubernetes cluster.
key features of mcp-server-kubernetes?
- Connect to a Kubernetes cluster
- List all pods, services, and deployments
- Create and delete pods
- List all namespaces
- Support for Helm to install charts
use cases of mcp-server-kubernetes?
- Managing Kubernetes resources directly from the command line.
- Automating deployment processes in a Kubernetes environment.
- Debugging applications by accessing pod logs.
FAQ from mcp-server-kubernetes?
- What do I need to run mcp-server-kubernetes?
You need kubectl installed, a valid kubeconfig file, and access to a Kubernetes cluster.
- Can I use mcp-server-kubernetes with any Kubernetes setup?
Yes, it works with various setups like minikube, Rancher Desktop, and GKE.
- Is there support for authentication?
Currently, authentication features are not planned.
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
{
"mcpServers": {
"kubernetes": {
"command": "npx",
"args": ["mcp-server-kubernetes"]
}
}
}
The server will automatically connect to your current kubectl context. Make sure you have:
- kubectl installed and in your PATH
- A valid kubeconfig file with contexts configured
- 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.
If you have errors, open up a standard terminal and run kubectl get pods
to see if you can connect to your cluster without credentials issues.
Features
- Connect to a Kubernetes cluster
- List all pods
- List all services
- List all deployments
- Create a pod
- Delete a pod
- 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
Development & Testing
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.