Kubectl MCP Server

Permite que asistentes de IA interactúen con clústeres de Kubernetes usando lenguaje natural.

Documentación

kubectl-mcp-server

Controla toda tu infraestructura de Kubernetes mediante conversaciones en lenguaje natural con IA.
Habla con tus clústeres como si hablaras con un experto en DevOps. Depura pods con fallos, optimiza costos, despliega aplicaciones, audita seguridad, gestiona gráficos de Helm y visualiza paneles, todo mediante lenguaje natural.
Parte del panorama CNCF, junto a Terraform

Instalación

Inicio rápido con npx (Recomendado - Sin instalación)

# Run directly without installation - works instantly!
npx -y kubectl-mcp-server

# Or install globally for faster startup
npm install -g kubectl-mcp-server

O instala con pip (Python)

# Standard installation
pip install kubectl-mcp-server

# With interactive UI dashboards (recommended)
pip install kubectl-mcp-server[ui]

📑 Tabla de contenidos

¿Qué puedes hacer?
¿Por qué kubectl-mcp-server?
Demostraciones en vivo
Instalación
- Inicio rápido con npx
- Instalar con pip
- Docker
Primeros pasos
Configuración rápida con tu asistente de IA
Todos los asistentes de IA compatibles
Conjunto completo de funciones
Uso de la CLI
Configuración avanzada
Funciones opcionales
- Paneles interactivos
- Automatización del navegador
Empresarial
Integraciones y ecosistema
Despliegue dentro del clúster
Soporte multi-clúster
Arquitectura
Habilidades del agente
Desarrollo y pruebas
Contribuciones
Soporte y comunidad

¿Qué puedes hacer?

Simplemente pregúntale a tu asistente de IA en lenguaje natural:

💬 "¿Por qué mi pod está fallando?"

Diagnóstico instantáneo de fallos con registros, eventos y análisis de recursos
Identificación de la causa raíz con recomendaciones accionables

💬 "Despliega un clúster de Redis con 3 réplicas"

Crea el despliegue con las mejores prácticas
Configura servicios, almacenamiento persistente y comprobaciones de salud

💬 "Muéstrame qué pods están desperdiciando recursos"

Análisis de optimización de costos impulsado por IA
Recomendaciones de recursos con ahorros potenciales

💬 "¿Qué servicios no pueden alcanzar la base de datos?"

Diagnósticos de conectividad de red con resolución DNS
Rastreo de la cadena de servicios desde el ingress hasta los pods

💬 "Audita la seguridad en todos los namespaces"

Análisis de permisos RBAC
Escaneo de seguridad de secretos y políticas de seguridad de pods

💬 "Muéstrame el panel del clúster"

Paneles HTML interactivos con métricas en vivo
Línea de tiempo visual de eventos y uso de recursos

253 herramientas potentes | 8 prompts de flujo de trabajo | 8 recursos de datos | Funciona con todos los asistentes de IA principales

¿Por qué kubectl-mcp-server?

🚀 Deja de cambiar de contexto - Gestiona Kubernetes directamente desde las conversaciones con tu asistente de IA
🧠 Diagnósticos impulsados por IA - Obtén solución de problemas inteligente, no solo datos sin procesar
💰 Optimización de costos integrada - Identifica desperdicios y obtén recomendaciones de ahorro accionables
🔒 Listo para empresas - Autenticación OAuth 2.1, validación RBAC, modo no destructivo, enmascaramiento de secretos
⚡ Sin curva de aprendizaje - Lenguaje natural en lugar de memorizar comandos de kubectl
🌐 Compatibilidad universal - Funciona con Claude, Cursor, Windsurf, Copilot y más de 15 otras herramientas de IA
📊 Información visual - Paneles interactivos y automatización del navegador para herramientas basadas en web
☸️ Calidad de producción - Despliega dentro del clúster con kMCP, 216 pruebas aprobadas, mantenimiento activo

Desde depurar pods con fallos hasta optimizar costos del clúster, kubectl-mcp-server es tu compañero DevOps impulsado por IA.

Demostraciones en vivo

Claude Desktop

Claude MCP

Cursor AI

Cursor MCP

Windsurf

Windsurf MCP

Instalación

Inicio rápido con npx (Recomendado - Sin instalación)

# Run directly without installation - works instantly!
npx -y kubectl-mcp-server

# Or install globally for faster startup
npm install -g kubectl-mcp-server

O instala con pip (Python)

# Standard installation
pip install kubectl-mcp-server

# With interactive UI dashboards (recommended)
pip install kubectl-mcp-server[ui]

Instalar desde la versión de GitHub

# Install specific version directly from GitHub release (replace {VERSION} with desired version)
pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v{VERSION}/kubectl_mcp_server-{VERSION}-py3-none-any.whl

# Example: Install v1.19.0
pip install https://github.com/rohitg00/kubectl-mcp-server/releases/download/v1.19.0/kubectl_mcp_server-1.19.0-py3-none-any.whl

# Or install latest from git
pip install git+https://github.com/rohitg00/kubectl-mcp-server.git

Requisitos previos

Python 3.9+ (para instalación con pip)
Node.js 14+ (para instalación con npx)
kubectl instalado y configurado
Acceso a un clúster de Kubernetes

Docker

# Pull from Docker Hub
docker pull rohitghumare64/kubectl-mcp-server:latest

# Or pull from GitHub Container Registry
docker pull ghcr.io/rohitg00/kubectl-mcp-server:latest

# Run with stdio transport
docker run -i -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest

# Run with HTTP transport
docker run -p 8000:8000 -v $HOME/.kube:/root/.kube:ro rohitghumare64/kubectl-mcp-server:latest --transport sse

Primeros pasos

1. Prueba el servidor (Opcional)

Antes de integrarlo con tu asistente de IA, verifica la instalación:

# Check if kubectl is configured
kubectl cluster-info

# Test the MCP server directly
kubectl-mcp-server info

# List all available tools
kubectl-mcp-server tools

# Try calling a tool
kubectl-mcp-server call get_pods '{"namespace": "kube-system"}'

2. Conéctate a tu asistente de IA

Elige tu asistente de IA favorito y añade la configuración:

Configuración rápida con tu asistente de IA

Claude Desktop

Añade a ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Cursor AI

Añade a ~/.cursor/mcp.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Windsurf

Añade a ~/.config/windsurf/mcp.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Usar Python en lugar de npx

{
  "mcpServers": {
    "kubernetes": {
      "command": "python",
      "args": ["-m", "kubectl_mcp_tool.mcp_server"],
      "env": {
        "KUBECONFIG": "/path/to/.kube/config"
      }
    }
  }
}

Más integraciones: GitHub Copilot, Goose, Gemini CLI, Roo Code y más de 15 otros clientes —> consulta la guía de configuración completa a continuación.

3. Reinicia tu asistente de IA

Después de añadir la configuración, reinicia tu asistente de IA (GitHub Copilot, Claude Code, Claude Desktop, Cursor, etc.) para cargar el servidor MCP.

4. Prueba estos comandos

Inicia una conversación con tu asistente de IA y prueba lo siguiente:

Solución de problemas:

"Show me all pods in the kube-system namespace"
"Why is the nginx-deployment pod crashing?"
"Diagnose network connectivity issues in the default namespace"

Despliegues:

"Create a deployment for nginx with 3 replicas"
"Scale my frontend deployment to 5 replicas"
"Roll back the api-server deployment to the previous version"

Costos y optimización:

"Which pods are using the most resources?"
"Show me idle resources that are wasting money"
"Analyze cost optimization opportunities in the production namespace"

Seguridad:

"Audit RBAC permissions in all namespaces"
"Check for insecure secrets and configurations"
"Show me pods running with privileged access"

Helm:

"List all Helm releases in the cluster"
"Install Redis from the Bitnami chart repository"
"Show me the values for my nginx-ingress Helm release"

Multi-clúster:

"List all available Kubernetes contexts"
"Switch to the production cluster context"
"Show me cluster information and version"

Compatibilidad con clientes MCP

Funciona perfectamente con todos los asistentes de IA compatibles con MCP:

Cliente	Estado	Cliente	Estado
Claude Desktop	✅ Nativo	Claude Code	✅ Nativo
Cursor	✅ Nativo	Windsurf	✅ Nativo
GitHub Copilot	✅ Nativo	OpenAI Codex	✅ Nativo
Gemini CLI	✅ Nativo	Goose	✅ Nativo
Roo Code	✅ Nativo	Kilo Code	✅ Nativo
Amp	✅ Nativo	Trae	✅ Nativo
OpenCode	✅ Nativo	Kiro CLI	✅ Nativo
Antigravity	✅ Nativo	Clawdbot	✅ Nativo
Droid (Factory)	✅ Nativo	Cualquier cliente MCP	✅ Compatible

Todos los asistentes de IA compatibles

Claude Code

Añade a ~/.config/claude-code/mcp.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

GitHub Copilot (VS Code)

Añade a settings.json de VS Code:

{
  "mcp": {
    "servers": {
      "kubernetes": {
        "command": "npx",
        "args": ["-y", "kubectl-mcp-server"]
      }
    }
  }
}

Goose

Añade a ~/.config/goose/config.yaml:

extensions:
  kubernetes:
    command: npx
    args:
      - -y
      - kubectl-mcp-server

Gemini CLI

Añade a ~/.gemini/settings.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Roo Code / Kilo Code

Añade a ~/.config/roo-code/mcp.json o ~/.config/kilo-code/mcp.json:

{
  "mcpServers": {
    "kubernetes": {
      "command": "npx",
      "args": ["-y", "kubectl-mcp-server"]
    }
  }
}

Conjunto completo de funciones

253 herramientas MCP para la gestión completa de Kubernetes

Categoría	Herramientas
Pods	`get_pods`, `get_logs`, `get_pod_events`, `check_pod_health`, `exec_in_pod`, `cleanup_pods`, `get_pod_conditions`, `get_previous_logs`
Deployments	`get_deployments`, `create_deployment`, `scale_deployment`, `kubectl_rollout`, `restart_deployment`
Cargas de trabajo	`get_statefulsets`, `get_daemonsets`, `get_jobs`, `get_replicasets`
Servicios y Redes	`get_services`, `get_ingress`, `get_endpoints`, `diagnose_network_connectivity`, `check_dns_resolution`, `trace_service_chain`
Almacenamiento	`get_persistent_volumes`, `get_pvcs`, `get_storage_classes`
Configuración	`get_configmaps`, `get_secrets`, `get_resource_quotas`, `get_limit_ranges`
Clúster	`get_nodes`, `get_namespaces`, `get_cluster_info`, `get_cluster_version`, `health_check`, `get_node_metrics`, `get_pod_metrics`
RBAC y Seguridad	`get_rbac_roles`, `get_cluster_roles`, `get_service_accounts`, `audit_rbac_permissions`, `check_secrets_security`, `get_pod_security_info`, `get_admission_webhooks`
CRDs	`get_crds`, `get_priority_classes`
Helm Releases	`helm_list`, `helm_status`, `helm_history`, `helm_get_values`, `helm_get_manifest`, `helm_get_notes`, `helm_get_hooks`, `helm_get_all`
Helm Charts	`helm_show_chart`, `helm_show_values`, `helm_show_readme`, `helm_show_crds`, `helm_show_all`, `helm_search_repo`, `helm_search_hub`
Helm Repos	`helm_repo_list`, `helm_repo_add`, `helm_repo_remove`, `helm_repo_update`
Operaciones Helm	`install_helm_chart`, `upgrade_helm_chart`, `uninstall_helm_chart`, `helm_rollback`, `helm_test`, `helm_template`, `helm_template_apply`
Desarrollo Helm	`helm_create`, `helm_lint`, `helm_package`, `helm_pull`, `helm_dependency_list`, `helm_dependency_update`, `helm_dependency_build`, `helm_version`, `helm_env`
Contexto	`get_current_context`, `switch_context`, `list_contexts`, `list_kubeconfig_contexts`
Diagnósticos	`diagnose_pod_crash`, `detect_pending_pods`, `get_evicted_pods`, `compare_namespaces`
Operaciones	`kubectl_apply`, `kubectl_create`, `kubectl_describe`, `kubectl_patch`, `delete_resource`, `kubectl_cp`, `backup_resource`, `label_resource`, `annotate_resource`, `taint_node`, `wait_for_condition`
Autoscaling	`get_hpa`, `get_pdb`
Optimización de Costos	`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`
Avanzado	`kubectl_generic`, `kubectl_explain`, `get_api_resources`, `port_forward`, `get_resource_usage`, `node_management`
Paneles UI	`show_pod_logs_ui`, `show_pods_dashboard_ui`, `show_resource_yaml_ui`, `show_cluster_overview_ui`, `show_events_timeline_ui`, `render_k8s_dashboard_screenshot`
GitOps (Flux/Argo)	`gitops_apps_list`, `gitops_app_get`, `gitops_app_sync`, `gitops_app_status`, `gitops_sources_list`, `gitops_source_get`, `gitops_detect_engine`
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`
Políticas (Kyverno/Gatekeeper)	`policy_list`, `policy_get`, `policy_violations_list`, `policy_explain_denial`, `policy_audit`, `policy_detect`
Respaldo (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`
Autoscaling KEDA	`keda_scaledobjects_list`, `keda_scaledobject_get`, `keda_scaledjobs_list`, `keda_triggerauths_list`, `keda_triggerauth_get`, `keda_hpa_list`, `keda_detect`
Cilium/Hubble	`cilium_policies_list`, `cilium_policy_get`, `cilium_endpoints_list`, `cilium_identities_list`, `cilium_nodes_list`, `cilium_status`, `hubble_flows_query`, `cilium_detect`
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`
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`
VMs KubeVirt	`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`
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`
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`
kind (K8s en 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`

Recursos MCP

Accede a datos de Kubernetes como recursos navegables:

URI del Recurso	Descripción
`kubeconfig://contexts`	Lista todos los contextos kubectl disponibles
`kubeconfig://current-context`	Obtiene el contexto activo actual
`namespace://current`	Obtiene el namespace actual
`namespace://list`	Lista todos los namespaces
`cluster://info`	Obtiene información del clúster
`cluster://nodes`	Obtiene información detallada de los nodos
`cluster://version`	Obtiene la versión de Kubernetes
`cluster://api-resources`	Lista los recursos de API disponibles
`manifest://deployments/{ns}/{name}`	Obtiene el YAML del deployment
`manifest://services/{ns}/{name}`	Obtiene el YAML del servicio
`manifest://pods/{ns}/{name}`	Obtiene el YAML del pod
`manifest://configmaps/{ns}/{name}`	Obtiene el YAML del ConfigMap
`manifest://secrets/{ns}/{name}`	Obtiene el YAML del secreto (datos enmascarados)
`manifest://ingresses/{ns}/{name}`	Obtiene el YAML del ingress

Prompts MCP

Prompts de flujos de trabajo predefinidos para operaciones comunes de Kubernetes:

Prompt	Descripción
`troubleshoot_workload`	Guía integral de solución de problemas para pods/deployments
`deploy_application`	Flujo de trabajo de deployment paso a paso
`security_audit`	Flujo de trabajo de análisis de seguridad y RBAC
`cost_optimization`	Flujo de trabajo de optimización de recursos y análisis de costos
`disaster_recovery`	Flujo de trabajo de planificación de respaldo y recuperación
`debug_networking`	Depuración de red para servicios y conectividad
`scale_application`	Guía de escalado con mejores prácticas de HPA/VPA
`upgrade_cluster`	Planificación de actualización del clúster de Kubernetes

Capacidades Clave

🤖 253 Herramientas Potentes - Gestión completa de Kubernetes desde pods hasta seguridad
🎯 8 Prompts de Flujos de Trabajo IA - Flujos de trabajo predefinidos para operaciones comunes
📊 8 Recursos MCP - Exposición de datos de Kubernetes navegables
🎨 6 Paneles Interactivos - Herramientas de UI HTML para gestión visual del clúster
🌐 26 Herramientas de Navegador - Automatización web con soporte de proveedores de nube
🔄 107 Herramientas de Ecosistema - GitOps, Cert-Manager, Políticas, Respaldo, KEDA, Cilium, Rollouts, CAPI, KubeVirt, Istio, vCluster
⚡ Multi-Transporte - stdio, SSE, HTTP, streamable-http
🔐 Seguridad Primero - Modo no destructivo, enmascaramiento de secretos, validación RBAC
🏥 Diagnósticos Avanzados - Solución de problemas impulsada por IA y optimización de costos
☸️ Multi-Clúster - Apunta a cualquier clúster mediante el parámetro de contexto en cada herramienta
🎡 Helm v3 Completo - Gestión completa del ciclo de vida de charts
🔧 CLI Potente - Descubrimiento de herramientas amigable para shell y llamada directa
🐳 Cloud Native - Despliegue en clúster con kMCP o kagent

Usando la CLI

La CLI integrada te permite explorar y probar herramientas sin un asistente de IA:

# List all tools with descriptions
kubectl-mcp-server tools -d

# Search for pod-related tools
kubectl-mcp-server grep "*pod*"

# Show specific tool schema
kubectl-mcp-server tools get_pods

# Call a tool directly
kubectl-mcp-server call get_pods '{"namespace": "kube-system"}'

# Pipe JSON from stdin
echo '{"namespace": "default"}' | kubectl-mcp-server call get_pods

# Check dependencies
kubectl-mcp-server doctor

# Show/switch Kubernetes context
kubectl-mcp-server context
kubectl-mcp-server context minikube

# List resources and prompts
kubectl-mcp-server resources
kubectl-mcp-server prompts

# Show server info
kubectl-mcp-server info

Características de la CLI

Errores estructurados: Mensajes de error accionables con sugerencias
Salida con colores: Legible para humanos con modo JSON para scripting (--json)
Soporte NO_COLOR: Respeta la variable de entorno NO_COLOR
Soporte stdin: Envía argumentos JSON por tubería a los comandos

Configuración Avanzada

Modos de Transporte

El servidor soporta múltiples protocolos de transporte:

# stdio (default) - Best for Claude Desktop, Cursor, Windsurf
kubectl-mcp-server
# or: python -m kubectl_mcp_tool.mcp_server

# SSE - Server-Sent Events for web clients
kubectl-mcp-server --transport sse --port 8000

# HTTP - Standard HTTP for REST clients
kubectl-mcp-server --transport http --port 8000

# streamable-http - For agentgateway integration
kubectl-mcp-server --transport streamable-http --port 8000

Opciones de Transporte:

--transport: Elige entre stdio, sse, http, streamable-http (predeterminado: stdio)
--host: Dirección de enlace (predeterminado: 0.0.0.0)
--port: Puerto para transportes de red (predeterminado: 8000)
--disable-destructive (o --non-destructive): Bloquea operaciones destructivas (permite crear/actualizar, bloquea eliminar)
--read-only: Bloquea todas las operaciones de escritura

Variables de Entorno

Configuración Principal:

Variable	Descripción	Predeterminado
`KUBECONFIG`	Ruta al archivo kubeconfig	`~/.kube/config`
`MCP_DEBUG`	Habilita registro detallado	`false`
`MCP_LOG_FILE`	Ruta del archivo de registro	Ninguno (stdout)

Autenticación (Enterprise):

Variable	Descripción	Predeterminado
`MCP_AUTH_ENABLED`	Habilita autenticación OAuth 2.1	`false`
`MCP_AUTH_ISSUER`	URL del servidor de autorización OAuth 2.0	-
`MCP_AUTH_JWKS_URI`	URL del endpoint JWKS	Derivada automáticamente
`MCP_AUTH_AUDIENCE`	Audiencia esperada del token	`kubectl-mcp-server`
`MCP_AUTH_REQUIRED_SCOPES`	Alcances OAuth requeridos	`mcp:tools`

Automatización de Navegador (Opcional):

Variable	Descripción	Predeterminado
`MCP_BROWSER_ENABLED`	Habilita herramientas de automatización de navegador	`false`
`MCP_BROWSER_PROVIDER`	Proveedor de nube (browserbase/browseruse)	Ninguno
`MCP_BROWSER_PROFILE`	Ruta de perfil persistente	Ninguno
`MCP_BROWSER_CDP_URL`	URL WebSocket CDP remota	Ninguno
`MCP_BROWSER_PROXY`	URL del servidor proxy	Ninguno

Opcional: Paneles Interactivos (6 Herramientas UI)

Obtén hermosos paneles HTML para la gestión visual del clúster.

Instalación:

# Install with UI support
pip install kubectl-mcp-server[ui]

6 Herramientas de Panel:

📊 show_pods_dashboard_ui - Tabla de estado de pods en tiempo real
📝 show_pod_logs_ui - Visor de registros interactivo con búsqueda
🎯 show_cluster_overview_ui - Panel completo del clúster
⚡ show_events_timeline_ui - Línea de tiempo de eventos con filtrado
📄 show_resource_yaml_ui - Visor YAML con resaltado de sintaxis
📸 render_k8s_dashboard_screenshot - Exporta paneles como PNG

Características:

🎨 Tema oscuro optimizado para terminales (Catppuccin)
🔄 Respaldo elegante a JSON para clientes incompatibles
🖼️ Renderizado de capturas de pantalla para compatibilidad universal
🚀 Cero dependencias externas

Funciona Con: Goose, LibreChat, Nanobot (UI HTML completa) | Claude Desktop, Cursor, otros (JSON + capturas de pantalla)

Opcional: Automatización de Navegador (26 Herramientas)

Automatiza operaciones web de Kubernetes con integración de agent-browser.

Configuración Rápida:

# Install agent-browser
npm install -g agent-browser
agent-browser install

# Enable browser tools
export MCP_BROWSER_ENABLED=true
kubectl-mcp-server

Lo Que Puedes Hacer:

🌐 Prueba aplicaciones desplegadas mediante URLs de Ingress
📸 Captura pantallas de Grafana, ArgoCD o cualquier panel de K8s
☁️ Automatiza operaciones de consolas de nube (EKS, GKE, AKS)
🏥 Verifica el estado de aplicaciones web
📄 Exporta paneles de monitoreo como PDF
🔐 Prueba flujos de autenticación con sesiones persistentes

26 Herramientas Disponibles: browser_open, browser_screenshot, browser_click, browser_fill, browser_test_ingress, browser_screenshot_grafana, browser_health_check, y 19 más

Características Avanzadas:

Proveedores de nube: Browserbase, Browser Use
Perfiles de navegador persistentes
Conexiones CDP remotas
Gestión de sesiones

Opcional: kubectl-mcp-app (8 Paneles UI Interactivos)

Un paquete npm independiente que proporciona paneles UI interactivos y hermosos para la gestión de Kubernetes usando el SDK de aplicaciones ext de MCP.

Instalación:

# Via npm
npm install -g kubectl-mcp-app

# Or via npx (no install)
npx kubectl-mcp-app

Configuración de Claude Desktop:

{
  "mcpServers": {
    "kubectl-app": {
      "command": "npx",
      "args": ["kubectl-mcp-app"]
    }
  }
}

8 Herramientas de UI Interactivas:

Herramienta	Descripción
`k8s-pods`	Visor interactivo de pods con filtrado, ordenamiento e indicadores de estado
`k8s-logs`	Visor de registros en tiempo real con resaltado de sintaxis y búsqueda
`k8s-deploy`	Panel de despliegues con estado de rollout, escalado y reversión
`k8s-helm`	Gestor de releases de Helm con acciones de actualización/reversión
`k8s-cluster`	Vista general del clúster con salud de nodos y métricas de recursos
`k8s-cost`	Analizador de costos con detección de desperdicio y recomendaciones
`k8s-events`	Línea de tiempo de eventos con filtrado por tipo y agrupación
`k8s-network`	Grafo de topología de red que muestra Services/Pods/Ingress

Características:

🎨 Soporte de tema oscuro/claro
📊 Visualización de datos en tiempo real
🖱️ Acciones interactivas (escalar, reiniciar, eliminar)
🔗 Integración perfecta con kubectl-mcp-server

Más información: Consulte kubectl-mcp-app/README.md para la documentación completa.

Empresa: Autenticación OAuth 2.1

Asegure su servidor MCP con autenticación OAuth 2.1 (RFC 9728).

export MCP_AUTH_ENABLED=true
export MCP_AUTH_ISSUER=https://your-idp.example.com
export MCP_AUTH_AUDIENCE=kubectl-mcp-server
kubectl-mcp-server --transport http --port 8000

Proveedores de identidad compatibles: Okta, Auth0, Keycloak, Microsoft Entra ID, Google OAuth y cualquier proveedor compatible con OIDC.

Caso de uso: Entornos multiinquilino, requisitos de cumplimiento, registro de auditoría.

Integraciones y Ecosistema

Docker MCP Toolkit

Funciona con Docker MCP Toolkit:

docker mcp server add kubectl-mcp-server mcp/kubectl-mcp-server:latest
docker mcp server configure kubectl-mcp-server --volume "$HOME/.kube:/root/.kube:ro"
docker mcp server enable kubectl-mcp-server
docker mcp client connect claude

agentregistry

Instale desde el agentregistry centralizado:

# Install arctl CLI
curl -fsSL https://raw.githubusercontent.com/agentregistry-dev/agentregistry/main/scripts/install.sh | bash

# Install kubectl-mcp-server
arctl mcp install io.github.rohitg00/kubectl-mcp-server

Disponible a través de: PyPI (uvx), npm (npx), OCI (docker.io/rohitghumare64/kubectl-mcp-server)

agentgateway

Enrute a múltiples servidores MCP a través de agentgateway:

# Start with streamable-http
kubectl-mcp-server --transport streamable-http --port 8000

# Configure gateway
cat > gateway.yaml <<EOF
binds:
- port: 3000
  listeners:
  - routes:
    - backends:
      - mcp:
          targets:
          - name: kubectl-mcp-server
            mcp:
              host: http://localhost:8000/mcp
EOF

# Start gateway
agentgateway --config gateway.yaml

Conecte clientes a http://localhost:3000/mcp para acceso unificado a las 253 herramientas.

Despliegue en el Clúster

Opción 1: kMCP (Recomendado)

Despliegue con kMCP - un plano de control para servidores MCP:

# Install kMCP
curl -fsSL https://raw.githubusercontent.com/kagent-dev/kmcp/refs/heads/main/scripts/get-kmcp.sh | bash
kmcp install

# Deploy kubectl-mcp-server (easiest)
kmcp deploy package --deployment-name kubectl-mcp-server \
   --manager npx --args kubectl-mcp-server

# Or with Docker image
kmcp deploy --file deploy/kmcp/kmcp.yaml --image rohitghumare64/kubectl-mcp-server:latest

Consulte inicio rápido de kMCP para más detalles.

Opción 2: Kubernetes Estándar

Despliegue con kubectl/kustomize:

# Using kustomize (recommended)
kubectl apply -k deploy/kubernetes/

# Or individual manifests
kubectl apply -f deploy/kubernetes/namespace.yaml
kubectl apply -f deploy/kubernetes/rbac.yaml
kubectl apply -f deploy/kubernetes/deployment.yaml
kubectl apply -f deploy/kubernetes/service.yaml

# Access via port-forward
kubectl port-forward -n kubectl-mcp svc/kubectl-mcp-server 8000:8000

Consulte el directorio deploy/ para todos los manifiestos y opciones de configuración.

Opción 3: kagent (Marco de Agentes de IA)

Integre con kagent - un marco de agentes de IA nativo de Kubernetes de CNCF:

# Install kagent
brew install kagent
kagent install --profile demo

# Register as ToolServer
kubectl apply -f deploy/kagent/toolserver-stdio.yaml

# Open dashboard
kagent dashboard

Sus agentes de IA ahora tienen acceso a las 253 herramientas de Kubernetes. Consulte inicio rápido de kagent.

Arquitectura

┌─────────────────┐     ┌──────────────────┐     ┌─────────────────┐
│   AI Assistant  │────▶│   MCP Server     │────▶│  Kubernetes API │
│ (Claude/Cursor) │◀────│ (kubectl-mcp)    │◀────│    (kubectl)    │
└─────────────────┘     └──────────────────┘     └─────────────────┘

El servidor MCP implementa el Model Context Protocol, traduciendo solicitudes en lenguaje natural a operaciones de kubectl.

Estructura Modular

kubectl_mcp_tool/
├── mcp_server.py          # Main server (FastMCP, transports)
├── tools/                  # 253 MCP tools organized by category
│   ├── pods.py            # Pod management & diagnostics
│   ├── deployments.py     # Deployments, StatefulSets, DaemonSets
│   ├── core.py            # Namespaces, ConfigMaps, Secrets
│   ├── cluster.py         # Context/cluster management
│   ├── networking.py      # Services, Ingress, NetworkPolicies
│   ├── storage.py         # PVCs, StorageClasses, PVs
│   ├── security.py        # RBAC, ServiceAccounts, PodSecurity
│   ├── helm.py            # Complete Helm v3 operations
│   ├── operations.py      # kubectl apply/patch/describe/etc
│   ├── diagnostics.py     # Metrics, namespace comparison
│   ├── cost.py            # Resource optimization & cost analysis
│   ├── ui.py              # MCP-UI interactive dashboards
│   ├── gitops.py          # GitOps (Flux/ArgoCD)
│   ├── certs.py           # Cert-Manager
│   ├── policy.py          # Policy (Kyverno/Gatekeeper)
│   ├── backup.py          # Backup (Velero)
│   ├── keda.py            # KEDA autoscaling
│   ├── cilium.py          # Cilium/Hubble network observability
│   ├── rollouts.py        # Argo Rollouts/Flagger
│   ├── capi.py            # Cluster API
│   ├── kubevirt.py        # KubeVirt VMs
│   ├── kiali.py           # Istio/Kiali service mesh
│   └── vind.py            # vCluster (virtual clusters)
├── resources/              # 8 MCP Resources for data exposure
├── prompts/                # 8 MCP Prompts for workflows
└── cli/                    # CLI interface

Habilidades de Agente (25 Habilidades para Agentes de Codificación de IA)

Extienda su agente de codificación de IA con experiencia en Kubernetes usando nuestra biblioteca de Habilidades de Agente. Las habilidades proporcionan conocimiento especializado y flujos de trabajo que los agentes pueden cargar bajo demanda.

Instalación Rápida

# Copy all skills to Claude
cp -r kubernetes-skills/claude/* ~/.claude/skills/

# Or install specific skills
cp -r kubernetes-skills/claude/k8s-helm ~/.claude/skills/

Habilidades Disponibles (25)

Categoría	Habilidades
Recursos Principales	k8s-core, k8s-networking, k8s-storage
Cargas de Trabajo	k8s-deploy, k8s-operations, k8s-helm
Observabilidad	k8s-diagnostics, k8s-troubleshoot, k8s-incident
Seguridad	k8s-security, k8s-policy, k8s-certs
GitOps	k8s-gitops, k8s-rollouts
Escalado	k8s-autoscaling, k8s-cost, k8s-backup
Multi-Clúster	k8s-multicluster, k8s-capi, k8s-kubevirt, k8s-vind
Redes	k8s-service-mesh, k8s-cilium
Herramientas	k8s-browser, k8s-cli

Convertir a Otros Agentes

Use SkillKit para convertir habilidades a su formato de agente de IA preferido:

npm install -g skillkit

# Convert to Cursor format
skillkit translate kubernetes-skills/claude --to cursor --output .cursor/rules/

# Convert to Codex format
skillkit translate kubernetes-skills/claude --to codex --output ./

Agentes compatibles: Claude, Cursor, Codex, Gemini CLI, GitHub Copilot, Goose, Windsurf, Roo, Amp y más.

Consulte kubernetes-skills/README.md para la documentación completa.

Soporte Multi-Clúster

Gestione sin problemas múltiples clústeres de Kubernetes mediante lenguaje natural. Cada herramienta admite un parámetro opcional context para apuntar a cualquier clúster sin cambiar de contexto.

Parámetro de Contexto (v1.15.0)

La mayoría de las herramientas basadas en kubectl aceptan un parámetro opcional context para apuntar a clústeres específicos. Nota: las herramientas vCluster (vind) y kind se ejecutan a través de sus CLIs locales y no aceptan el parámetro context.

Hable con su asistente de IA:

"List pods in the production cluster"
"Get deployments from staging context"
"Show logs from the api-pod in the dev cluster"
"Compare namespaces between production and staging clusters"

Llamadas directas a herramientas con contexto:

# Target a specific cluster context
kubectl-mcp-server call get_pods '{"namespace": "default", "context": "production"}'

# Get deployments from staging
kubectl-mcp-server call get_deployments '{"namespace": "app", "context": "staging"}'

# Install Helm chart to production cluster
kubectl-mcp-server call install_helm_chart '{"name": "redis", "chart": "bitnami/redis", "namespace": "cache", "context": "production"}'

# Compare resources across clusters
kubectl-mcp-server call compare_namespaces '{"namespace1": "prod-ns", "namespace2": "staging-ns", "context": "production"}'

Gestión de Contexto

Hable con su asistente de IA:

"List all available Kubernetes contexts"
"Switch to the production cluster"
"Show me details about the staging context"
"What's the current cluster I'm connected to?"

O use la CLI directamente:

kubectl-mcp-server context                    # Show current context
kubectl-mcp-server context production         # Switch context
kubectl-mcp-server call list_contexts_tool    # List all contexts via MCP

Cómo Funciona

Si se omite context, la herramienta usa su contexto kubectl actual
Si se especifica context, la herramienta apunta directamente a ese clúster
La respuesta incluye "context": "production" o "context": "current" para mayor claridad
Funciona con todas las configuraciones de kubeconfig y respeta la variable de entorno KUBECONFIG
No es necesario cambiar de contexto para operaciones entre clústeres

Desarrollo y Pruebas

Configurar Entorno de Desarrollo

# Clone the repository
git clone https://github.com/rohitg00/kubectl-mcp-server.git
cd kubectl-mcp-server

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install development dependencies
pip install -r requirements-dev.txt

Ejecutar Pruebas

# Run all tests
pytest tests/ -v

# Run specific test file
pytest tests/test_tools.py -v

# Run with coverage
pytest tests/ --cov=kubectl_mcp_tool --cov-report=html

# Run only unit tests
pytest tests/ -v -m unit

Estructura de Pruebas

tests/
├── __init__.py          # Test package
├── conftest.py          # Shared fixtures and mocks
├── test_tools.py        # Unit tests for 253 MCP tools
├── test_resources.py    # Tests for 8 MCP Resources
├── test_prompts.py      # Tests for 8 MCP Prompts
└── test_server.py       # Server initialization tests

234 pruebas que cubren: registro de herramientas, exposición de recursos, generación de prompts, inicialización del servidor, modo no destructivo, enmascaramiento de secretos, manejo de errores, métodos de transporte, comandos CLI, automatización de navegador y herramientas de ecosistema.

Calidad de Código

# Format code
black kubectl_mcp_tool tests

# Sort imports
isort kubectl_mcp_tool tests

# Lint
flake8 kubectl_mcp_tool tests

# Type checking
mypy kubectl_mcp_tool

Contribuciones

¡Nos encantan las contribuciones! Ya sea informes de errores, solicitudes de funciones, mejoras de documentación o contribuciones de código.

Formas de contribuir:

🐛 Informe errores a través de GitHub Issues
💡 Sugiera funciones o mejoras
📝 Mejore la documentación
🔧 Envíe solicitudes de extracción
⭐ Marque el proyecto con una estrella si le resulta útil!

Configuración de desarrollo: Consulte la sección Desarrollo y Pruebas anterior.

Antes de enviar un PR:

Ejecute las pruebas: pytest tests/ -v
Formatee el código: black kubectl_mcp_tool tests
Verifique el linting: flake8 kubectl_mcp_tool tests

Soporte y Comunidad

Licencia

Licencia MIT - consulte LICENSE para más detalles.

Enlaces y Recursos

Repositorios de Paquetes:

Proyecto:

Ecosistema:

📚 Protocolo de Contexto de Modelo
☸️ Documentación de Kubernetes

Hecho con ❤️ para la comunidad de Kubernetes e IA

Si kubectl-mcp-server hace su vida de DevOps más fácil, ¡dale una ⭐ en GitHub!