MCP Kubernetes Server
This is an MCP (Model Context Protocol) server for Kubernetes that provides control over Kubernetes clusters through interactions with LLMs.
Overview
This client allows you to perform common Kubernetes operations through MCP tools. It wraps kubectl commands to provide a simple interface for managing Kubernetes resources. The Model Context Protocol (MCP) enables seamless interaction between language models and Kubernetes operations.
What is MCP?
Model Context Protocol (MCP) is a framework that enables Language Models to interact with external tools and services in a structured way. It provides:
- A standardized way to expose functionality to language models
- Context management for operations
- Tool discovery and documentation
- Type-safe interactions between models and tools
Usage Examples
- Create a new deployment for me with name nginx-app and image nginx:latest in the production namespace with 3 replicas.
- Update the deployment nginx-app to version 1.19 in the production namespace.
- Scale the deployment nginx-app to 5 replicas in the production namespace.
- Get me the pods in the production namespace.
- Get me all namespaces in the cluster.
- Get me all nodes in the cluster.
- Get me all services in the cluster.
- Get me all deployments in the cluster.
- Get me all jobs in the cluster.
- Get me all cronjobs in the cluster.
- Get me all statefulsets in the cluster.
- Get me all daemonsets in the cluster.
LLM Integration
This MCP client is designed to work seamlessly with Large Language Models (LLMs). The functions are decorated with @mcp.tool(), making them accessible to LLMs through the Model Context Protocol framework.
Example LLM Prompts
LLMs can interact with your Kubernetes cluster using natural language. Here are some example prompts:
- "Create a new nginx deployment with 3 replicas in the production namespace"
- "Scale the nginx-app deployment to 5 replicas"
- "Update the image of nginx-app to version 1.19"
The LLM will interpret these natural language requests and call the appropriate MCP functions with the correct parameters.
Benefits of LLM Integration
- Natural Language Interface : Manage Kubernetes resources using conversational language
- Reduced Command Complexity : No need to remember exact kubectl syntax
- Error Prevention : LLMs can validate inputs and provide helpful error messages
- Context Awareness : LLMs can maintain context across multiple operations
- Structured Interactions : MCP ensures type-safe and documented interactions between LLMs and tools
Requirements
- Kubernetes cluster access configured via
kubectl
- Python 3.x
- MCP framework installed and configured
Security Note
When using this client with LLMs, ensure that:
- Proper access controls are in place for your Kubernetes cluster
- The MCP server is running in a secure environment
- API access is properly authenticated and authorized
Usage with Claude Desktop
{
"mcpServers": {
"Kubernetes": {
"command": "uv",
"args": [
"--directory",
"~/mcp/mcp-k8s-server",
"run",
"kubernetes.py"
]
}
}
}
Contributing
We welcome contributions to the MCP Kubernetes Server! If you'd like to contribute:
- Fork the repository
- Create a new branch for your feature (
git checkout -b feature/amazing-feature)
- Make your changes
- Write or update tests as needed
- Commit your changes (
git commit -m 'Add some amazing feature')
- Push to your branch (
git push origin feature/amazing-feature)
- Open a Pull Request
For major changes, please open an issue first to discuss what you would like to change.
