Provides tools for querying, analyzing, and generating Kubernetes resources, enabling natural-language-powered operations such as pod root-cause analysis, cross-environment deployment diffing, and manifest generation.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@K8s Lens MCP Why is my nginx pod crashing?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A Model Context Protocol (MCP) server for intelligent, natural-language-powered Kubernetes operations.
Stop memorizing kubectl flags. Ask your cluster questions in plain English.
K8s Lens MCP exposes deep analytical tools to any MCP-compatible AI assistant (Claude, Cursor, Copilot, etc.):
Capability | Example Prompt |
Smart Resource Queries | "Show me all pods with status |
Pod Root-Cause Analysis | "Why is this pod failing?" — correlates events, logs, resource limits, and node conditions |
Cross-Environment Diff | "Diff the nginx deployment between |
Manifest Generation | "Create a basic nginx deployment with 2 replicas and a LoadBalancer service" |
Unlike thin kubectl wrappers, K8s Lens MCP analyzes and correlates data so the AI can give you real answers, not just raw command output.
Related MCP server: Kubernetes MCP Server
pip install k8s-lens-mcpOr with Poetry:
poetry add k8s-lens-mcpAdd to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"k8s-lens": {
"command": "k8s-lens-mcp",
"args": []
}
}
}Add to Cursor Settings → MCP:
{
"mcpServers": {
"k8s-lens": {
"command": "k8s-lens-mcp",
"args": []
}
}
}Open Claude or Cursor and ask:
"Show me all failing pods in the default namespace and tell me why they're failing."
Read-only by default — the server starts in --read-only mode. No accidental deletions.
RBAC-respecting — we use your kubeconfig / ServiceAccount. We don't bypass Kubernetes permissions.
Secret masking — Kubernetes Secret data is never returned in tool output.
To enable read-write mode (future feature):
k8s-lens-mcp --read-only=falsePython 3.11+
Poetry
A Kubernetes cluster (e.g. kind, minikube, or a remote cluster)
git clone https://github.com/yourusername/k8s-lens-mcp.git
cd k8s-lens-mcp
poetry installpoetry run k8s-lens-mcpnpx @modelcontextprotocol/inspector poetry run k8s-lens-mcppoetry run pytestpoetry run ruff check .
poetry run ruff format .Core MCP server scaffold
get_resources — filtered resource queries
analyze_pod — multi-signal root cause analysis
compare_deployments — cross-environment diffing
generate_manifest — best-practice manifest generation
Cost / resource optimization advisor
Multi-cluster context aggregation
Helm release values diffing
In-cluster deployment (Helm chart)
kubectl plugin wrapper (kubectl lens "...")
We welcome contributions! See CONTRIBUTING.md for guidelines.
Please read our Code of Conduct.
This server cannot be deployed
Fail-closed policy guardrails for AI agents running kubectl, terraform, helm, and argocd.
Deploy, monitor, and manage your OpenClaw AI assistants via natural language.
Ask data questions in natural language. Get SQL, insights, and charts from your databases.
Query your team's drift, vulnerability, and upgrade data from any AI assistant. OAuth 2.1, 51 tools.
