{"id":26937350,"url":"https://github.com/rohitg00/kubectl-mcp-server","last_synced_at":"2026-08-27T17:33:44.366Z","repository":{"id":284024066,"uuid":"953587943","full_name":"rohitg00/kubectl-mcp-server","owner":"rohitg00","description":"Published in CNCF Landscape: A MCP server for Kubernetes.","archived":false,"fork":false,"pushed_at":"2026-04-08T22:37:48.000Z","size":100311,"stargazers_count":954,"open_issues_count":6,"forks_count":181,"subscribers_count":14,"default_branch":"main","last_synced_at":"2026-08-23T15:41:36.699Z","etag":null,"topics":["ai","deployment","devops","genai","kubernetes","kubernetes-cluster","kubernetes-tools","llms","mcp","mcp-server","npm","pypi"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/kubectl-mcp-server","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/rohitg00.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"github":["rohitg00"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"lfx_crowdfunding":null,"custom":null}},"created_at":"2025-03-23T17:49:07.000Z","updated_at":"2026-08-19T08:10:34.000Z","dependencies_parsed_at":null,"dependency_job_id":"546d8719-fb76-4124-a99b-bc3a9c58037a","html_url":"https://github.com/rohitg00/kubectl-mcp-server","commit_stats":null,"previous_names":["rohitg00/kubectl-mcp-server"],"tags_count":27,"template":false,"template_full_name":null,"purl":"pkg:github/rohitg00/kubectl-mcp-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitg00%2Fkubectl-mcp-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitg00%2Fkubectl-mcp-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitg00%2Fkubectl-mcp-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitg00%2Fkubectl-mcp-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/rohitg00","download_url":"https://codeload.github.com/rohitg00/kubectl-mcp-server/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/rohitg00%2Fkubectl-mcp-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":36853877,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-08-22T15:14:58.755Z","status":"online","status_checked_at":"2026-08-23T02:00:05.822Z","response_time":128,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai","deployment","devops","genai","kubernetes","kubernetes-cluster","kubernetes-tools","llms","mcp","mcp-server","npm","pypi"],"created_at":"2025-04-02T13:15:09.183Z","updated_at":"2026-08-27T17:33:44.352Z","avatar_url":"https://github.com/rohitg00.png","language":"Python","funding_links":["https://github.com/sponsors/rohitg00"],"categories":["Cloud Infrastructure","Cloud \u0026 Infrastructure","Cloud \u0026 DevOps MCP Servers","📚 Projects (1974 total)","MCP 服务器精选列表","🤖 AI/ML","サーバー実装","Python","Task and Project Management","Developer Tools","☁️ Cloud Platforms","Containerised MCP Servers","Cloud Platforms","MCP Servers","MCP Servers \u0026 Protocol","☁️ Cloud Platforms (38 servers)","Server Implementations","Table of Contents","Servers"],"sub_categories":["🐳 Container Orchestration","Kubernetes","MCP Servers","☁️ 云平台与服务集成 (AWS, Cloudflare, Azure, K8s, etc.)","☁️ \u003ca name=\"cloud-platforms\"\u003e\u003c/a\u003eクラウドプラットフォーム","How to Submit","DevOps \u0026 Infrastructure","Cloud \u0026 DevOps","☁️ \u003ca name=\"cloud-platforms\"\u003e\u003c/a\u003eCloud Platforms","AI Services","Developer Tools"],"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"logos/kubectl-mcp-server-icon.svg\" alt=\"kubectl-mcp-server logo\" width=\"80\" height=\"80\"\u003e\n  \u003cbr\u003e\n  \u003cstrong style=\"font-size: 24px;\"\u003ekubectl-mcp-server\u003c/strong\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n\u003cb\u003eControl your entire Kubernetes infrastructure through natural language conversations with AI.\u003c/b\u003e\u003cbr\u003e\nTalk to your clusters like you talk to a DevOps expert. Debug crashed pods, optimize costs, deploy applications, audit security, manage Helm charts, and visualize dashboards, all through natural language.\u003cbr\u003e\n\u003cb\u003ePart of CNCF Landscape, Next to Terraform\u003c/b\u003e\n\u003c/p\u003e\n\n\u003cimg width=\"2473\" height=\"1332\" alt=\"Screenshot 2026-04-08 at 23 36 21\" src=\"https://github.com/user-attachments/assets/616b4e65-37bc-474e-8124-68e64c6d7c95\" /\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/rohitg00/kubectl-mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/github/stars/rohitg00/kubectl-mcp-server?style=flat\u0026logo=github\" alt=\"GitHub Stars\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://opensource.org/licenses/MIT\"\u003e\u003cimg src=\"https://img.shields.io/badge/License-MIT-yellow.svg\" alt=\"License: MIT\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.python.org/\"\u003e\u003cimg src=\"https://img.shields.io/badge/python-3.9+-blue.svg\" alt=\"Python\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://kubernetes.io/\"\u003e\u003cimg src=\"https://img.shields.io/badge/kubernetes-%23326ce5.svg?style=flat\u0026logo=kubernetes\u0026logoColor=white\" alt=\"Kubernetes\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://modelcontextprotocol.io\"\u003e\u003cimg src=\"https://img.shields.io/badge/MCP-compatible-green.svg\" alt=\"MCP\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://pypi.org/project/kubectl-mcp-server/\"\u003e\u003cimg src=\"https://img.shields.io/pypi/v/kubectl-mcp-server?color=blue\u0026label=PyPI\" alt=\"PyPI\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://www.npmjs.com/package/kubectl-mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/npm/v/kubectl-mcp-server?color=green\u0026label=npm\" alt=\"npm\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/docker/pulls/rohitghumare64/kubectl-mcp-server.svg\" alt=\"Docker\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://github.com/rohitg00/kubectl-mcp-server\"\u003e\u003cimg src=\"https://img.shields.io/badge/tests-234%20passed-success\" \n  \u003ca href=\"https://deepwiki.com/rohitg00/kubectl-mcp-server\"\u003e\u003cimg src=\"https://deepwiki.com/badge.svg\" alt=\"Ask DeepWiki\"\u003e\u003c/a\u003e\n  \u003ca href=\"https://aregistry.ai\"\u003e\u003cimg src=\"https://img.shields.io/badge/agentregistry-verified-blue?logo=data:image/svg+xml;base64,PHN2ZyB4bWxucz0iaHR0cDovL3d3dy53My5vcmcvMjAwMC9zdmciIHdpZHRoPSIxNiIgaGVpZ2h0PSIxNiIgZmlsbD0id2hpdGUiIHZpZXdCb3g9IjAgMCAxNiAxNiI+PHBhdGggZD0iTTE1Ljk5MiA2LjAzN2wtMy4wMjEtLjQzOS0xLjM1LTIuNzM2Yy0uMzQ2LS43MDItMS41MDQtLjcwMi0xLjg1IDBMOC40MjEgNS41OTggNS40IDYuMDM3Yy0uNzc2LjExMy0xLjA4OCAxLjA1My0uNTI4IDEuNTkzbDIuMTg2IDIuMTI5LS41MTYgMy4wMWMtLjEzMy43NzUuNjgyIDEuMzY2IDEuMzc4Ljk5OGwyLjcwMi0xLjQyIDIuNzAyIDEuNDJjLjY5Ni4zNjggMS41MTEtLjIyMyAxLjM3OC0uOTk4bC0uNTE2LTMuMDEgMi4xODYtMi4xMjljLjU2LS41NCAwLjI0OC0xLjQ4LS41MjgtMS41OTN6Ii8+PC9zdmc+\" alt=\"agentregistry\"\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n## Installation\n\n### Quick Start with npx (Recommended - Zero Install)\n\n```bash\n# Run directly without installation - works instantly!\nnpx -y kubectl-mcp-server\n\n# Or install globally for faster startup\nnpm install -g kubectl-mcp-server\n```\n\n### Or install with pip (Python)\n\n```bash\n# Standard installation\npip install kubectl-mcp-server\n\n# With interactive UI dashboards (recommended)\npip install kubectl-mcp-server[ui]\n```\n---\n\n## 📑 Table of Contents\n\n- [What Can You Do?](#what-can-you-do)\n- [Why kubectl-mcp-server?](#why-kubectl-mcp-server)\n- [Live Demos](#live-demos)\n- [Installation](#installation)\n  - [Quick Start with npx](#quick-start-with-npx-recommended---zero-install)\n  - [Install with pip](#or-install-with-pip-python)\n  - [Docker](#docker)\n- [Getting Started](#getting-started)\n- [Quick Setup with Your AI Assistant](#quick-setup-with-your-ai-assistant)\n- [All Supported AI Assistants](#all-supported-ai-assistants)\n- [Complete Feature Set](#complete-feature-set)\n- [Using the CLI](#using-the-cli)\n- [Advanced Configuration](#advanced-configuration)\n- [Optional Features](#optional-interactive-dashboards-6-ui-tools)\n  - [Interactive Dashboards](#optional-interactive-dashboards-6-ui-tools)\n  - [Browser Automation](#optional-browser-automation-26-tools)\n- [Enterprise](#enterprise-oauth-21-authentication)\n- [Integrations \u0026 Ecosystem](#integrations--ecosystem)\n- [In-Cluster Deployment](#in-cluster-deployment)\n- [Multi-Cluster Support](#multi-cluster-support)\n- [Architecture](#architecture)\n- [Agent Skills](#agent-skills-24-skills-for-ai-coding-agents)\n- [Development \u0026 Testing](#development--testing)\n- [Contributing](#contributing)\n- [Support \u0026 Community](#support--community)\n\n---\n\n## What Can You Do?\n\nSimply ask your AI assistant in natural language:\n\n💬 **\"Why is my pod crashing?\"**\n- Instant crash diagnosis with logs, events, and resource analysis\n- Root cause identification with actionable recommendations\n\n💬 **\"Deploy a Redis cluster with 3 replicas\"**\n- Creates deployment with best practices\n- Configures services, persistent storage, and health checks\n\n💬 **\"Show me which pods are wasting resources\"**\n- AI-powered cost optimization analysis\n- Resource recommendations with potential savings\n\n💬 **\"Which services can't reach the database?\"**\n- Network connectivity diagnostics with DNS resolution\n- Service chain tracing from ingress to pods\n\n💬 **\"Audit security across all namespaces\"**\n- RBAC permission analysis\n- Secret security scanning and pod security policies\n\n💬 **\"Show me the cluster dashboard\"**\n- Interactive HTML dashboards with live metrics\n- Visual timeline of events and resource usage\n\n**253 powerful tools** | **8 workflow prompts** | **8 data resources** | **Works with all major AI assistants**\n\n## Why kubectl-mcp-server?\n\n- **🚀 Stop context-switching** - Manage Kubernetes directly from your AI assistant conversations\n- **🧠 AI-powered diagnostics** - Get intelligent troubleshooting, not just raw data\n- **💰 Built-in cost optimization** - Identify waste and get actionable savings recommendations\n- **🔒 Enterprise-ready** - OAuth 2.1 auth, RBAC validation, non-destructive mode, secret masking\n- **⚡ Zero learning curve** - Natural language instead of memorizing kubectl commands\n- **🌐 Universal compatibility** - Works with Claude, Cursor, Windsurf, Copilot, and 15+ other AI tools\n- **📊 Visual insights** - Interactive dashboards and browser automation for web-based tools\n- **☸️ Production-grade** - Deploy in-cluster with kMCP, 216 passing tests, active maintenance\n\nFrom debugging crashed pods to optimizing cluster costs, kubectl-mcp-server is your AI-powered DevOps companion.\n\n## Live Demos\n\n### Claude Desktop\n![Claude MCP](./docs/claude/claude-mcp.gif)\n\n### Cursor AI\n![Cursor MCP](./docs/cursor/cursor-mcp.gif)\n\n### Windsurf\n![Windsurf MCP](./docs/windsurf/windsurf-mcp.gif)\n\n## Installation\n\n### Quick Start with npx (Recommended - Zero Install)\n\n```bash\n# Run directly without installation - works instantly!\nnpx -y kubectl-mcp-server\n\n# Or install globally for faster startup\nnpm install -g kubectl-mcp-server\n```\n\n### Or install with pip (Python)\n\n```bash\n# Standard installation\npip install kubectl-mcp-server\n\n# With interactive UI dashboards (recommended)\npip install kubectl-mcp-server[ui]\n```\n\n### Install from GitHub Release\n\n```bash\n# Install specific version directly from GitHub release (replace {VERSION} with desired version)\npip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v{VERSION}/kubectl_mcp_server-{VERSION}-py3-none-any.whl\n\n# Example: Install v1.19.0\npip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v1.19.0/kubectl_mcp_server-1.19.0-py3-none-any.whl\n\n# Or install latest from git\npip install git+https://github.com/rohitg00/kubectl-mcp-server.git\n```\n\n### Prerequisites\n- **Python 3.9+** (for pip installation)\n- **Node.js 14+** (for npx installation)\n- **kubectl** installed and configured\n- Access to a Kubernetes cluster\n\n### Docker\n\n```bash\n# Pull from Docker Hub\ndocker pull rohitghumare64/kubectl-mcp-server:latest\n\n# Or pull from GitHub Container Registry\ndocker pull ghcr.io/rohitg00/kubectl-mcp-server:latest\n\n# Run with stdio transport\ndocker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest\n\n# Run with HTTP transport\ndocker run -p 8000:8000 -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest --transport sse\n```\n\n## Getting Started\n\n### 1. Test the Server (Optional)\n\nBefore integrating with your AI assistant, verify the installation:\n\n```bash\n# Check if kubectl is configured\nkubectl cluster-info\n\n# Test the MCP server directly\nkubectl-mcp-server info\n\n# List all available tools\nkubectl-mcp-server tools\n\n# Try calling a tool\nkubectl-mcp-server call get_pods '{\"namespace\": \"kube-system\"}'\n```\n\n### 2. Connect to Your AI Assistant\n\nChoose your favorite AI assistant and add the configuration:\n\n## Quick Setup with Your AI Assistant\n\n### Claude Desktop\n\nAdd to `~/Library/Application Support/Claude/claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n### Cursor AI\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n### Windsurf\n\nAdd to `~/.config/windsurf/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n### Using Python Instead of npx\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"python\",\n      \"args\": [\"-m\", \"kubectl_mcp_tool.mcp_server\"],\n      \"env\": {\n        \"KUBECONFIG\": \"/path/to/.kube/config\"\n      }\n    }\n  }\n}\n```\n\n**More integrations**: GitHub Copilot, Goose, Gemini CLI, Roo Code, and [15+ other clients](#mcp-client-compatibility) —\u003e see [full configuration guide](#all-supported-ai-assistants) below.\n\n### 3. Restart Your AI Assistant\n\nAfter adding the configuration, restart your AI assistant **(GitHub Copilot, Claude Code,Claude Desktop, Cursor, etc.)** to load the MCP server.\n\n### 4. Try These Commands\n\nStart a conversation with your AI assistant and try these:\n\n**Troubleshooting:**\n```\n\"Show me all pods in the kube-system namespace\"\n\"Why is the nginx-deployment pod crashing?\"\n\"Diagnose network connectivity issues in the default namespace\"\n```\n\n**Deployments:**\n```\n\"Create a deployment for nginx with 3 replicas\"\n\"Scale my frontend deployment to 5 replicas\"\n\"Roll back the api-server deployment to the previous version\"\n```\n\n**Cost \u0026 Optimization:**\n```\n\"Which pods are using the most resources?\"\n\"Show me idle resources that are wasting money\"\n\"Analyze cost optimization opportunities in the production namespace\"\n```\n\n**Security:**\n```\n\"Audit RBAC permissions in all namespaces\"\n\"Check for insecure secrets and configurations\"\n\"Show me pods running with privileged access\"\n```\n\n**Helm:**\n```\n\"List all Helm releases in the cluster\"\n\"Install Redis from the Bitnami chart repository\"\n\"Show me the values for my nginx-ingress Helm release\"\n```\n\n**Multi-Cluster:**\n```\n\"List all available Kubernetes contexts\"\n\"Switch to the production cluster context\"\n\"Show me cluster information and version\"\n```\n\n## MCP Client Compatibility\n\nWorks seamlessly with **all MCP-compatible AI assistants**:\n\n| Client | Status | Client | Status |\n|--------|--------|--------|--------|\n| Claude Desktop | ✅ Native | Claude Code | ✅ Native |\n| Cursor | ✅ Native | Windsurf | ✅ Native |\n| GitHub Copilot | ✅ Native | OpenAI Codex | ✅ Native |\n| Gemini CLI | ✅ Native | Goose | ✅ Native |\n| Roo Code | ✅ Native | Kilo Code | ✅ Native |\n| Amp | ✅ Native | Trae | ✅ Native |\n| OpenCode | ✅ Native | Kiro CLI | ✅ Native |\n| Antigravity | ✅ Native | Clawdbot | ✅ Native |\n| Droid (Factory) | ✅ Native | Any MCP Client | ✅ Compatible |\n\n## All Supported AI Assistants\n\n### Claude Code\n\nAdd to `~/.config/claude-code/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n### GitHub Copilot (VS Code)\n\nAdd to VS Code `settings.json`:\n\n```json\n{\n  \"mcp\": {\n    \"servers\": {\n      \"kubernetes\": {\n        \"command\": \"npx\",\n        \"args\": [\"-y\", \"kubectl-mcp-server\"]\n      }\n    }\n  }\n}\n```\n\n### Goose\n\nAdd to `~/.config/goose/config.yaml`:\n\n```yaml\nextensions:\n  kubernetes:\n    command: npx\n    args:\n      - -y\n      - kubectl-mcp-server\n```\n\n### Gemini CLI\n\nAdd to `~/.gemini/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n### Roo Code / Kilo Code\n\nAdd to `~/.config/roo-code/mcp.json` or `~/.config/kilo-code/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"kubernetes\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"kubectl-mcp-server\"]\n    }\n  }\n}\n```\n\n## Complete Feature Set\n\n### 253 MCP Tools for Complete Kubernetes Management\n\n| Category | Tools |\n|----------|-------|\n| **Pods** | `get_pods`, `get_logs`, `get_pod_events`, `check_pod_health`, `exec_in_pod`, `cleanup_pods`, `get_pod_conditions`, `get_previous_logs` |\n| **Deployments** | `get_deployments`, `create_deployment`, `scale_deployment`, `kubectl_rollout`, `restart_deployment` |\n| **Workloads** | `get_statefulsets`, `get_daemonsets`, `get_jobs`, `get_replicasets` |\n| **Services \u0026 Networking** | `get_services`, `get_ingress`, `get_endpoints`, `diagnose_network_connectivity`, `check_dns_resolution`, `trace_service_chain` |\n| **Storage** | `get_persistent_volumes`, `get_pvcs`, `get_storage_classes` |\n| **Config** | `get_configmaps`, `get_secrets`, `get_resource_quotas`, `get_limit_ranges` |\n| **Cluster** | `get_nodes`, `get_namespaces`, `get_cluster_info`, `get_cluster_version`, `health_check`, `get_node_metrics`, `get_pod_metrics` |\n| **RBAC \u0026 Security** | `get_rbac_roles`, `get_cluster_roles`, `get_service_accounts`, `audit_rbac_permissions`, `check_secrets_security`, `get_pod_security_info`, `get_admission_webhooks` |\n| **CRDs** | `get_crds`, `get_priority_classes` |\n| **Helm Releases** | `helm_list`, `helm_status`, `helm_history`, `helm_get_values`, `helm_get_manifest`, `helm_get_notes`, `helm_get_hooks`, `helm_get_all` |\n| **Helm Charts** | `helm_show_chart`, `helm_show_values`, `helm_show_readme`, `helm_show_crds`, `helm_show_all`, `helm_search_repo`, `helm_search_hub` |\n| **Helm Repos** | `helm_repo_list`, `helm_repo_add`, `helm_repo_remove`, `helm_repo_update` |\n| **Helm Operations** | `install_helm_chart`, `upgrade_helm_chart`, `uninstall_helm_chart`, `helm_rollback`, `helm_test`, `helm_template`, `helm_template_apply` |\n| **Helm Development** | `helm_create`, `helm_lint`, `helm_package`, `helm_pull`, `helm_dependency_list`, `helm_dependency_update`, `helm_dependency_build`, `helm_version`, `helm_env` |\n| **Context** | `get_current_context`, `switch_context`, `list_contexts`, `list_kubeconfig_contexts` |\n| **Diagnostics** | `diagnose_pod_crash`, `detect_pending_pods`, `get_evicted_pods`, `compare_namespaces` |\n| **Operations** | `kubectl_apply`, `kubectl_create`, `kubectl_describe`, `kubectl_patch`, `delete_resource`, `kubectl_cp`, `backup_resource`, `label_resource`, `annotate_resource`, `taint_node`, `wait_for_condition` |\n| **Autoscaling** | `get_hpa`, `get_pdb` |\n| **Cost Optimization** | `get_resource_recommendations`, `get_idle_resources`, `get_resource_quotas_usage`, `get_cost_analysis`, `get_overprovisioned_resources`, `get_resource_trends`, `get_namespace_cost_allocation`, `optimize_resource_requests` |\n| **Advanced** | `kubectl_generic`, `kubectl_explain`, `get_api_resources`, `port_forward`, `get_resource_usage`, `node_management` |\n| **UI Dashboards** | `show_pod_logs_ui`, `show_pods_dashboard_ui`, `show_resource_yaml_ui`, `show_cluster_overview_ui`, `show_events_timeline_ui`, `render_k8s_dashboard_screenshot` |\n| **GitOps (Flux/Argo)** | `gitops_apps_list`, `gitops_app_get`, `gitops_app_sync`, `gitops_app_status`, `gitops_sources_list`, `gitops_source_get`, `gitops_detect_engine` |\n| **Cert-Manager** | `certs_list`, `certs_get`, `certs_issuers_list`, `certs_issuer_get`, `certs_renew`, `certs_status_explain`, `certs_challenges_list`, `certs_requests_list`, `certs_detect` |\n| **Policy (Kyverno/Gatekeeper)** | `policy_list`, `policy_get`, `policy_violations_list`, `policy_explain_denial`, `policy_audit`, `policy_detect` |\n| **Backup (Velero)** | `backup_list`, `backup_get`, `backup_create`, `backup_delete`, `restore_list`, `restore_create`, `restore_get`, `backup_locations_list`, `backup_schedules_list`, `backup_schedule_create`, `backup_detect` |\n| **KEDA Autoscaling** | `keda_scaledobjects_list`, `keda_scaledobject_get`, `keda_scaledjobs_list`, `keda_triggerauths_list`, `keda_triggerauth_get`, `keda_hpa_list`, `keda_detect` |\n| **Cilium/Hubble** | `cilium_policies_list`, `cilium_policy_get`, `cilium_endpoints_list`, `cilium_identities_list`, `cilium_nodes_list`, `cilium_status`, `hubble_flows_query`, `cilium_detect` |\n| **Argo Rollouts/Flagger** | `rollouts_list`, `rollout_get`, `rollout_status`, `rollout_promote`, `rollout_abort`, `rollout_retry`, `rollout_restart`, `analysis_runs_list`, `flagger_canaries_list`, `flagger_canary_get`, `rollouts_detect` |\n| **Cluster API** | `capi_clusters_list`, `capi_cluster_get`, `capi_machines_list`, `capi_machine_get`, `capi_machinedeployments_list`, `capi_machinedeployment_scale`, `capi_machinesets_list`, `capi_machinehealthchecks_list`, `capi_clusterclasses_list`, `capi_cluster_kubeconfig`, `capi_detect` |\n| **KubeVirt VMs** | `kubevirt_vms_list`, `kubevirt_vm_get`, `kubevirt_vmis_list`, `kubevirt_vm_start`, `kubevirt_vm_stop`, `kubevirt_vm_restart`, `kubevirt_vm_pause`, `kubevirt_vm_unpause`, `kubevirt_vm_migrate`, `kubevirt_datasources_list`, `kubevirt_instancetypes_list`, `kubevirt_datavolumes_list`, `kubevirt_detect` |\n| **Istio/Kiali** | `istio_virtualservices_list`, `istio_virtualservice_get`, `istio_destinationrules_list`, `istio_gateways_list`, `istio_peerauthentications_list`, `istio_authorizationpolicies_list`, `istio_proxy_status`, `istio_analyze`, `istio_sidecar_status`, `istio_detect` |\n| **vCluster (vind)** | `vind_detect_tool`, `vind_list_clusters_tool`, `vind_status_tool`, `vind_get_kubeconfig_tool`, `vind_logs_tool`, `vind_create_cluster_tool`, `vind_delete_cluster_tool`, `vind_pause_tool`, `vind_resume_tool`, `vind_connect_tool`, `vind_disconnect_tool`, `vind_upgrade_tool`, `vind_describe_tool`, `vind_platform_start_tool` |\n| **kind (K8s in Docker)** | `kind_detect_tool`, `kind_version_tool`, `kind_list_clusters_tool`, `kind_get_nodes_tool`, `kind_get_kubeconfig_tool`, `kind_export_logs_tool`, `kind_cluster_info_tool`, `kind_node_labels_tool`, `kind_create_cluster_tool`, `kind_delete_cluster_tool`, `kind_delete_all_clusters_tool`, `kind_load_image_tool`, `kind_load_image_archive_tool`, `kind_build_node_image_tool`, `kind_set_kubeconfig_tool` |\n\n### MCP Resources\n\nAccess Kubernetes data as browsable resources:\n\n| Resource URI | Description |\n|--------------|-------------|\n| `kubeconfig://contexts` | List all available kubectl contexts |\n| `kubeconfig://current-context` | Get current active context |\n| `namespace://current` | Get current namespace |\n| `namespace://list` | List all namespaces |\n| `cluster://info` | Get cluster information |\n| `cluster://nodes` | Get detailed node information |\n| `cluster://version` | Get Kubernetes version |\n| `cluster://api-resources` | List available API resources |\n| `manifest://deployments/{ns}/{name}` | Get deployment YAML |\n| `manifest://services/{ns}/{name}` | Get service YAML |\n| `manifest://pods/{ns}/{name}` | Get pod YAML |\n| `manifest://configmaps/{ns}/{name}` | Get ConfigMap YAML |\n| `manifest://secrets/{ns}/{name}` | Get secret YAML (data masked) |\n| `manifest://ingresses/{ns}/{name}` | Get ingress YAML |\n\n### MCP Prompts\n\nPre-built workflow prompts for common Kubernetes operations:\n\n| Prompt | Description |\n|--------|-------------|\n| `troubleshoot_workload` | Comprehensive troubleshooting guide for pods/deployments |\n| `deploy_application` | Step-by-step deployment workflow |\n| `security_audit` | Security scanning and RBAC analysis workflow |\n| `cost_optimization` | Resource optimization and cost analysis workflow |\n| `disaster_recovery` | Backup and recovery planning workflow |\n| `debug_networking` | Network debugging for services and connectivity |\n| `scale_application` | Scaling guide with HPA/VPA best practices |\n| `upgrade_cluster` | Kubernetes cluster upgrade planning |\n\n### Key Capabilities\n\n- 🤖 **253 Powerful Tools** - Complete Kubernetes management from pods to security\n- 🎯 **8 AI Workflow Prompts** - Pre-built workflows for common operations\n- 📊 **8 MCP Resources** - Browsable Kubernetes data exposure\n- 🎨 **6 Interactive Dashboards** - HTML UI tools for visual cluster management\n- 🌐 **26 Browser Tools** - Web automation with cloud provider support\n- 🔄 **107 Ecosystem Tools** - GitOps, Cert-Manager, Policy, Backup, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster\n- ⚡ **Multi-Transport** - stdio, SSE, HTTP, streamable-http\n- 🔐 **Security First** - Non-destructive mode, secret masking, RBAC validation\n- 🏥 **Advanced Diagnostics** - AI-powered troubleshooting and cost optimization\n- ☸️ **Multi-Cluster** - Target any cluster via context parameter in every tool\n- 🎡 **Full Helm v3** - Complete chart lifecycle management\n- 🔧 **Powerful CLI** - Shell-friendly tool discovery and direct calling\n- 🐳 **Cloud Native** - Deploy in-cluster with kMCP or kagent\n\n## Using the CLI\n\nThe built-in CLI lets you explore and test tools without an AI assistant:\n\n```bash\n# List all tools with descriptions\nkubectl-mcp-server tools -d\n\n# Search for pod-related tools\nkubectl-mcp-server grep \"*pod*\"\n\n# Show specific tool schema\nkubectl-mcp-server tools get_pods\n\n# Call a tool directly\nkubectl-mcp-server call get_pods '{\"namespace\": \"kube-system\"}'\n\n# Pipe JSON from stdin\necho '{\"namespace\": \"default\"}' | kubectl-mcp-server call get_pods\n\n# Check dependencies\nkubectl-mcp-server doctor\n\n# Show/switch Kubernetes context\nkubectl-mcp-server context\nkubectl-mcp-server context minikube\n\n# List resources and prompts\nkubectl-mcp-server resources\nkubectl-mcp-server prompts\n\n# Show server info\nkubectl-mcp-server info\n```\n\n### CLI Features\n\n- **Structured errors**: Actionable error messages with suggestions\n- **Colorized output**: Human-readable with JSON mode for scripting (`--json`)\n- **NO_COLOR support**: Respects `NO_COLOR` environment variable\n- **Stdin support**: Pipe JSON arguments to commands\n\n## Advanced Configuration\n\n### Transport Modes\n\nThe server supports multiple transport protocols:\n\n```bash\n# stdio (default) - Best for Claude Desktop, Cursor, Windsurf\nkubectl-mcp-server\n# or: python -m kubectl_mcp_tool.mcp_server\n\n# SSE - Server-Sent Events for web clients\nkubectl-mcp-server --transport sse --port 8000\n\n# HTTP - Standard HTTP for REST clients\nkubectl-mcp-server --transport http --port 8000\n\n# streamable-http - For agentgateway integration\nkubectl-mcp-server --transport streamable-http --port 8000\n```\n\n**Transport Options:**\n- `--transport`: Choose from `stdio`, `sse`, `http`, `streamable-http` (default: `stdio`)\n- `--host`: Bind address (default: `0.0.0.0`)\n- `--port`: Port for network transports (default: `8000`)\n- `--disable-destructive` (or `--non-destructive`): Block destructive operations (allow create/update, block delete)\n- `--read-only`: Block all write operations\n\n### Environment Variables\n\n**Core Settings:**\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `KUBECONFIG` | Path to kubeconfig file | `~/.kube/config` |\n| `MCP_DEBUG` | Enable verbose logging | `false` |\n| `MCP_LOG_FILE` | Log file path | None (stdout) |\n\n**Authentication (Enterprise):**\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `MCP_AUTH_ENABLED` | Enable OAuth 2.1 authentication | `false` |\n| `MCP_AUTH_ISSUER` | OAuth 2.0 Authorization Server URL | - |\n| `MCP_AUTH_JWKS_URI` | JWKS endpoint URL | Auto-derived |\n| `MCP_AUTH_AUDIENCE` | Expected token audience | `kubectl-mcp-server` |\n| `MCP_AUTH_REQUIRED_SCOPES` | Required OAuth scopes | `mcp:tools` |\n\n**Browser Automation (Optional):**\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `MCP_BROWSER_ENABLED` | Enable browser automation tools | `false` |\n| `MCP_BROWSER_PROVIDER` | Cloud provider (browserbase/browseruse) | None |\n| `MCP_BROWSER_PROFILE` | Persistent profile path | None |\n| `MCP_BROWSER_CDP_URL` | Remote CDP WebSocket URL | None |\n| `MCP_BROWSER_PROXY` | Proxy server URL | None |\n\n## Optional: Interactive Dashboards (6 UI Tools)\n\nGet beautiful HTML dashboards for visual cluster management.\n\n**Installation:**\n\n```bash\n# Install with UI support\npip install kubectl-mcp-server[ui]\n```\n\n**6 Dashboard Tools:**\n- 📊 `show_pods_dashboard_ui` - Real-time pod status table\n- 📝 `show_pod_logs_ui` - Interactive log viewer with search\n- 🎯 `show_cluster_overview_ui` - Complete cluster dashboard\n- ⚡ `show_events_timeline_ui` - Events timeline with filtering\n- 📄 `show_resource_yaml_ui` - YAML viewer with syntax highlighting\n- 📸 `render_k8s_dashboard_screenshot` - Export dashboards as PNG\n\n**Features:**\n- 🎨 Dark theme optimized for terminals (Catppuccin)\n- 🔄 Graceful fallback to JSON for incompatible clients\n- 🖼️ Screenshot rendering for universal compatibility\n- 🚀 Zero external dependencies\n\n**Works With**: Goose, LibreChat, Nanobot (full HTML UI) | Claude Desktop, Cursor, others (JSON + screenshots)\n\n## Optional: Browser Automation (26 Tools)\n\nAutomate web-based Kubernetes operations with [agent-browser](https://github.com/vercel-labs/agent-browser) integration.\n\n**Quick Setup:**\n\n```bash\n# Install agent-browser\nnpm install -g agent-browser\nagent-browser install\n\n# Enable browser tools\nexport MCP_BROWSER_ENABLED=true\nkubectl-mcp-server\n```\n\n**What You Can Do:**\n- 🌐 Test deployed apps via Ingress URLs\n- 📸 Screenshot Grafana, ArgoCD, or any K8s dashboard\n- ☁️ Automate cloud console operations (EKS, GKE, AKS)\n- 🏥 Health check web applications\n- 📄 Export monitoring dashboards as PDF\n- 🔐 Test authentication flows with persistent sessions\n\n**26 Available Tools**: `browser_open`, `browser_screenshot`, `browser_click`, `browser_fill`, `browser_test_ingress`, `browser_screenshot_grafana`, `browser_health_check`, and [19 more](https://github.com/rohitg00/kubectl-mcp-server#browser-tools)\n\n**Advanced Features**:\n- Cloud providers: Browserbase, Browser Use\n- Persistent browser profiles\n- Remote CDP connections\n- Session management\n\n## Optional: kubectl-mcp-app (8 Interactive UI Dashboards)\n\nA standalone npm package that provides beautiful, interactive UI dashboards for Kubernetes management using the MCP ext-apps SDK.\n\n**Installation:**\n\n```bash\n# Via npm\nnpm install -g kubectl-mcp-app\n\n# Or via npx (no install)\nnpx kubectl-mcp-app\n```\n\n**Claude Desktop Configuration:**\n\n```json\n{\n  \"mcpServers\": {\n    \"kubectl-app\": {\n      \"command\": \"npx\",\n      \"args\": [\"kubectl-mcp-app\"]\n    }\n  }\n}\n```\n\n**8 Interactive UI Tools:**\n\n| Tool | Description |\n| ---- | ----------- |\n| `k8s-pods` | Interactive pod viewer with filtering, sorting, status indicators |\n| `k8s-logs` | Real-time log viewer with syntax highlighting and search |\n| `k8s-deploy` | Deployment dashboard with rollout status, scaling, rollback |\n| `k8s-helm` | Helm release manager with upgrade/rollback actions |\n| `k8s-cluster` | Cluster overview with node health and resource metrics |\n| `k8s-cost` | Cost analyzer with waste detection and recommendations |\n| `k8s-events` | Events timeline with type filtering and grouping |\n| `k8s-network` | Network topology graph showing Services/Pods/Ingress |\n\n**Features:**\n- 🎨 Dark/light theme support\n- 📊 Real-time data visualization\n- 🖱️ Interactive actions (scale, restart, delete)\n- 🔗 Seamless integration with kubectl-mcp-server\n\n**More Info**: See [kubectl-mcp-app/README.md](./kubectl-mcp-app/README.md) for full documentation.\n\n## Enterprise: OAuth 2.1 Authentication\n\nSecure your MCP server with OAuth 2.1 authentication (RFC 9728).\n\n```bash\nexport MCP_AUTH_ENABLED=true\nexport MCP_AUTH_ISSUER=https://your-idp.example.com\nexport MCP_AUTH_AUDIENCE=kubectl-mcp-server\nkubectl-mcp-server --transport http --port 8000\n```\n\n**Supported Identity Providers**: Okta, Auth0, Keycloak, Microsoft Entra ID, Google OAuth, and any OIDC-compliant provider.\n\n**Use Case**: Multi-tenant environments, compliance requirements, audit logging.\n\n## Integrations \u0026 Ecosystem\n\n### Docker MCP Toolkit\n\nWorks with [Docker MCP Toolkit](https://docs.docker.com/ai/mcp-catalog-and-toolkit/toolkit/):\n\n```bash\ndocker mcp server add kubectl-mcp-server mcp/kubectl-mcp-server:latest\ndocker mcp server configure kubectl-mcp-server --volume \"$HOME/.kube:/root/.kube:ro\"\ndocker mcp server enable kubectl-mcp-server\ndocker mcp client connect claude\n```\n\n### agentregistry\n\nInstall from the centralized [agentregistry](https://aregistry.ai):\n\n```bash\n# Install arctl CLI\ncurl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/install.sh | bash\n\n# Install kubectl-mcp-server\narctl mcp install io.github.rohitg00/kubectl-mcp-server\n```\n\n**Available via**: PyPI (`uvx`), npm (`npx`), OCI (`docker.io/rohitghumare64/kubectl-mcp-server`)\n\n### agentgateway\n\nRoute to multiple MCP servers through [agentgateway](https://github.com/agentgateway/agentgateway):\n\n```bash\n# Start with streamable-http\nkubectl-mcp-server --transport streamable-http --port 8000\n\n# Configure gateway\ncat \u003e gateway.yaml \u003c\u003cEOF\nbinds:\n- port: 3000\n  listeners:\n  - routes:\n    - backends:\n      - mcp:\n          targets:\n          - name: kubectl-mcp-server\n            mcp:\n              host: http://localhost:8000/mcp\nEOF\n\n# Start gateway\nagentgateway --config gateway.yaml\n```\n\nConnect clients to `http://localhost:3000/mcp` for unified access to all 253 tools.\n\n## In-Cluster Deployment\n\n### Option 1: kMCP (Recommended)\n\nDeploy with [kMCP](https://github.com/kagent-dev/kmcp) - a control plane for MCP servers:\n\n```bash\n# Install kMCP\ncurl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash\nkmcp install\n\n# Deploy kubectl-mcp-server (easiest)\nkmcp deploy package --deployment-name kubectl-mcp-server \\\n   --manager npx --args kubectl-mcp-server\n\n# Or with Docker image\nkmcp deploy --file deploy/kmcp/kmcp.yaml --image rohitghumare64/kubectl-mcp-server:latest\n```\n\nSee [kMCP quickstart](https://kagent.dev/docs/kmcp/quickstart) for details.\n\n### Option 2: Standard Kubernetes\n\nDeploy with kubectl/kustomize:\n\n```bash\n# Using kustomize (recommended)\nkubectl apply -k deploy/kubernetes/\n\n# Or individual manifests\nkubectl apply -f deploy/kubernetes/namespace.yaml\nkubectl apply -f deploy/kubernetes/rbac.yaml\nkubectl apply -f deploy/kubernetes/deployment.yaml\nkubectl apply -f deploy/kubernetes/service.yaml\n\n# Access via port-forward\nkubectl port-forward -n kubectl-mcp svc/kubectl-mcp-server 8000:8000\n```\n\nSee [deploy/](deploy/) directory for all manifests and configuration options.\n\n### Option 3: kagent (AI Agent Framework)\n\nIntegrate with [kagent](https://github.com/kagent-dev/kagent) - a CNCF Kubernetes-native AI agent framework:\n\n```bash\n# Install kagent\nbrew install kagent\nkagent install --profile demo\n\n# Register as ToolServer\nkubectl apply -f deploy/kagent/toolserver-stdio.yaml\n\n# Open dashboard\nkagent dashboard\n```\n\nYour AI agents now have access to all 253 Kubernetes tools. See [kagent quickstart](https://kagent.dev/docs/kagent/getting-started/quickstart).\n\n## Architecture\n\n```\n┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐\n│   AI Assistant  │────▶│   MCP Server     │────▶│  Kubernetes API │\n│ (Claude/Cursor) │◀────│ (kubectl-mcp)    │◀────│    (kubectl)    │\n└─────────────────┘     └──────────────────┘     └─────────────────┘\n```\n\nThe MCP server implements the [Model Context Protocol](https://github.com/modelcontextprotocol/spec), translating natural language requests into kubectl operations.\n\n### Modular Structure\n\n```\nkubectl_mcp_tool/\n├── mcp_server.py          # Main server (FastMCP, transports)\n├── tools/                  # 253 MCP tools organized by category\n│   ├── pods.py            # Pod management \u0026 diagnostics\n│   ├── deployments.py     # Deployments, StatefulSets, DaemonSets\n│   ├── core.py            # Namespaces, ConfigMaps, Secrets\n│   ├── cluster.py         # Context/cluster management\n│   ├── networking.py      # Services, Ingress, NetworkPolicies\n│   ├── storage.py         # PVCs, StorageClasses, PVs\n│   ├── security.py        # RBAC, ServiceAccounts, PodSecurity\n│   ├── helm.py            # Complete Helm v3 operations\n│   ├── operations.py      # kubectl apply/patch/describe/etc\n│   ├── diagnostics.py     # Metrics, namespace comparison\n│   ├── cost.py            # Resource optimization \u0026 cost analysis\n│   ├── ui.py              # MCP-UI interactive dashboards\n│   ├── gitops.py          # GitOps (Flux/ArgoCD)\n│   ├── certs.py           # Cert-Manager\n│   ├── policy.py          # Policy (Kyverno/Gatekeeper)\n│   ├── backup.py          # Backup (Velero)\n│   ├── keda.py            # KEDA autoscaling\n│   ├── cilium.py          # Cilium/Hubble network observability\n│   ├── rollouts.py        # Argo Rollouts/Flagger\n│   ├── capi.py            # Cluster API\n│   ├── kubevirt.py        # KubeVirt VMs\n│   ├── kiali.py           # Istio/Kiali service mesh\n│   └── vind.py            # vCluster (virtual clusters)\n├── resources/              # 8 MCP Resources for data exposure\n├── prompts/                # 8 MCP Prompts for workflows\n└── cli/                    # CLI interface\n```\n\n## Agent Skills (25 Skills for AI Coding Agents)\n\nExtend your AI coding agent with Kubernetes expertise using our [Agent Skills](https://agenstskills.com) library. Skills provide specialized knowledge and workflows that agents can load on demand.\n\n### Quick Install\n\n```bash\n# Copy all skills to Claude\ncp -r kubernetes-skills/claude/* ~/.claude/skills/\n\n# Or install specific skills\ncp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/\n```\n\n### Available Skills (25)\n\n| Category | Skills |\n|----------|--------|\n| **Core Resources** | k8s-core, k8s-networking, k8s-storage |\n| **Workloads** | k8s-deploy, k8s-operations, k8s-helm |\n| **Observability** | k8s-diagnostics, k8s-troubleshoot, k8s-incident |\n| **Security** | k8s-security, k8s-policy, k8s-certs |\n| **GitOps** | k8s-gitops, k8s-rollouts |\n| **Scaling** | k8s-autoscaling, k8s-cost, k8s-backup |\n| **Multi-Cluster** | k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind |\n| **Networking** | k8s-service-mesh, k8s-cilium |\n| **Tools** | k8s-browser, k8s-cli |\n\n### Convert to Other Agents\n\nUse [SkillKit](https://github.com/rohitg00/skillkit) to convert skills to your preferred AI agent format:\n\n```bash\nnpm install -g skillkit\n\n# Convert to Cursor format\nskillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/\n\n# Convert to Codex format\nskillkit translate kubernetes-skills/claude --to codex --output ./\n```\n\n**Supported agents:** Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp, and more.\n\nSee [kubernetes-skills/README.md](kubernetes-skills/README.md) for full documentation.\n\n## Multi-Cluster Support\n\nSeamlessly manage multiple Kubernetes clusters through natural language. **Every tool** supports an optional `context` parameter to target any cluster without switching contexts.\n\n### Context Parameter (v1.15.0)\n\nMost kubectl-backed tools accept an optional `context` parameter to target specific clusters.\nNote: vCluster (vind) and kind tools run via their local CLIs and do not accept the `context` parameter.\n\n**Talk to your AI assistant:**\n```\n\"List pods in the production cluster\"\n\"Get deployments from staging context\"\n\"Show logs from the api-pod in the dev cluster\"\n\"Compare namespaces between production and staging clusters\"\n```\n\n**Direct tool calls with context:**\n```bash\n# Target a specific cluster context\nkubectl-mcp-server call get_pods '{\"namespace\": \"default\", \"context\": \"production\"}'\n\n# Get deployments from staging\nkubectl-mcp-server call get_deployments '{\"namespace\": \"app\", \"context\": \"staging\"}'\n\n# Install Helm chart to production cluster\nkubectl-mcp-server call install_helm_chart '{\"name\": \"redis\", \"chart\": \"bitnami/redis\", \"namespace\": \"cache\", \"context\": \"production\"}'\n\n# Compare resources across clusters\nkubectl-mcp-server call compare_namespaces '{\"namespace1\": \"prod-ns\", \"namespace2\": \"staging-ns\", \"context\": \"production\"}'\n```\n\n### Context Management\n\n**Talk to your AI assistant:**\n```\n\"List all available Kubernetes contexts\"\n\"Switch to the production cluster\"\n\"Show me details about the staging context\"\n\"What's the current cluster I'm connected to?\"\n```\n\n**Or use the CLI directly:**\n```bash\nkubectl-mcp-server context                    # Show current context\nkubectl-mcp-server context production         # Switch context\nkubectl-mcp-server call list_contexts_tool    # List all contexts via MCP\n```\n\n### How It Works\n\n- If `context` is omitted, the tool uses your current kubectl context\n- If `context` is specified, the tool targets that cluster directly\n- Response includes `\"context\": \"production\"` or `\"context\": \"current\"` for clarity\n- Works with all kubeconfig setups and respects `KUBECONFIG` environment variable\n- No need to switch contexts for cross-cluster operations\n\n## Development \u0026 Testing\n\n### Setup Development Environment\n\n```bash\n# Clone the repository\ngit clone https://github.com/rohitg00/kubectl-mcp-server.git\ncd kubectl-mcp-server\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # On Windows: venv\\Scripts\\activate\n\n# Install development dependencies\npip install -r requirements-dev.txt\n```\n\n### Running Tests\n\n```bash\n# Run all tests\npytest tests/ -v\n\n# Run specific test file\npytest tests/test_tools.py -v\n\n# Run with coverage\npytest tests/ --cov=kubectl_mcp_tool --cov-report=html\n\n# Run only unit tests\npytest tests/ -v -m unit\n```\n\n### Test Structure\n\n```\ntests/\n├── __init__.py          # Test package\n├── conftest.py          # Shared fixtures and mocks\n├── test_tools.py        # Unit tests for 253 MCP tools\n├── test_resources.py    # Tests for 8 MCP Resources\n├── test_prompts.py      # Tests for 8 MCP Prompts\n└── test_server.py       # Server initialization tests\n```\n\n**234 tests covering**: tool registration, resource exposure, prompt generation, server initialization, non-destructive mode, secret masking, error handling, transport methods, CLI commands, browser automation, and ecosystem tools.\n\n### Code Quality\n\n```bash\n# Format code\nblack kubectl_mcp_tool tests\n\n# Sort imports\nisort kubectl_mcp_tool tests\n\n# Lint\nflake8 kubectl_mcp_tool tests\n\n# Type checking\nmypy kubectl_mcp_tool\n```\n\n## Contributing\n\nWe ❤️ contributions! Whether it's bug reports, feature requests, documentation improvements, or code contributions.\n\n**Ways to contribute:**\n- 🐛 Report bugs via [GitHub Issues](https://github.com/rohitg00/kubectl-mcp-server/issues)\n- 💡 Suggest features or improvements\n- 📝 Improve documentation\n- 🔧 Submit pull requests\n- ⭐ Star the project if you find it useful!\n\n**Development setup**: See [Development \u0026 Testing](#development--testing) section above.\n\n**Before submitting a PR:**\n1. Run tests: `pytest tests/ -v`\n2. Format code: `black kubectl_mcp_tool tests`\n3. Check linting: `flake8 kubectl_mcp_tool tests`\n\n## Support \u0026 Community\n\n- 📖 [Documentation](https://github.com/rohitg00/kubectl-mcp-server#readme)\n- 💬 [GitHub Discussions](https://github.com/rohitg00/kubectl-mcp-server/discussions)\n- 🐛 [Issue Tracker](https://github.com/rohitg00/kubectl-mcp-server/issues)\n- 🎯 [Feature Requests](https://github.com/rohitg00/kubectl-mcp-server/issues/new)\n- 🌟 [agentregistry Profile](https://aregistry.ai)\n\n## License\n\nMIT License - see [LICENSE](LICENSE) for details.\n\n## Links \u0026 Resources\n\n**Package Repositories:**\n- 🐍 [PyPI Package](https://pypi.org/project/kubectl-mcp-server/)\n- 📦 [npm Package](https://www.npmjs.com/package/kubectl-mcp-server)\n- 🐳 [Docker Hub](https://hub.docker.com/r/rohitghumare64/kubectl-mcp-server)\n\n**Project:**\n- 🔧 [GitHub Repository](https://github.com/rohitg00/kubectl-mcp-server)\n- 🐛 [Issue Tracker](https://github.com/rohitg00/kubectl-mcp-server/issues)\n- 📋 [Changelog](https://github.com/rohitg00/kubectl-mcp-server/releases)\n\n**Ecosystem:**\n- 📚 [Model Context Protocol](https://modelcontextprotocol.io)\n- ☸️ [Kubernetes Documentation](https://kubernetes.io/docs)\n\n---\n\n**Made with ❤️ for the Kubernetes and AI community**\n\nIf **kubectl-mcp-server** makes your DevOps life easier, give it a ⭐ on [GitHub](https://github.com/rohitg00/kubectl-mcp-server)!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohitg00%2Fkubectl-mcp-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Frohitg00%2Fkubectl-mcp-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Frohitg00%2Fkubectl-mcp-server/lists"}