mcp-kubernetes

Un servidor de Model Context Protocol para Kubernetes. Permite que un cliente compatible con MCP (Claude Desktop, Claude Code, etc.) inspecciones y funciones clústeres de Kubernetes en varios contextos, con el comportamiento controlado por completo mediante flags.

El objetivo de diseño es seguro por defecto: arranca en modo solo lectura, puede escindirse una allowlist de namespaces y contextos, protege los namespaces del sistema de mutaciones y restringe las operaciones peligrosas (delete, apply, exec) tras autorizaciones explícitas.

Características

• Multi-cluster — cada herramienta acepta un context opcional; limita qué contextos se pueden usar con una allowlist.

• Modos de acceso — read-only → read-write → admin, en capas para que un modo nunca exponga herramientas por encima del nivel.

• Flags de seguridad — allowlist de namespaces, namespaces protegidos, allowlist de contextos, además de autorizaciones independientes para delete / apply / exec, dry-run y deposito de auditoría JSON (ver más abajo).

• Autenticación estándar — usa tu kube-config (o la cuenta de servicio del clúster). El servidor no guarda credenciales.

Related MCP server: k8s-mcp-go

Modelo de seguridad

Las capas son independientes — por ejemplo, admin con los tres opt-ins en false puede reiniciar y escalar deployments, pero no puede eliminar recursos ni ejecutar en pods.

Herramientas

Lectura (read-only+): list_contexts, list_namespaces, list_pods, get_pod, get_pod_logs, list_deployments, list_services, list_nodes, list_events, get_resource

Escritura (read-write+): scale_deployment, restart_deployment, set_deployment_image, create_namespace, apply_manifest (requiere K8S_ALLOW_APPLY)

Admin (admin): delete_resource (requiere K8S_ALLOW_DELETE), exec_in_pod (requiere K8S_ALLOW_EXEC)

Uso con tu cliente MCP

Funciona con Claude Code, Claude Desktop, Cursor, OpenAI Codex CLI, Windsurf, VS Code (Copilot), y cualquier otro cliente MCP — consulta docs/CLIENTS.md para la configuración por cliente.

Instalación

npm install
npm run build

Ejecutar con Claude Desktop / Claude Code

Agrega a la configuración de tu cliente MCP:

{
  "mcpServers": {
    "kubernetes": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-kubernetes/dist/index.js"],
      "env": {
        "KUBECONFIG_PATH": "/Users/you/.kube/config",
        "K8S_MODE": "read-only",
        "K8S_CONTEXT_ALLOWLIST": "staging",
        "K8S_NAMESPACE_ALLOWLIST": "app,web"
      }
    }
  }
}

Cambia K8S_MODE a read-write para escalar / reiniciar, y a admin (más el flag K8S_ALLOW_* correspondiente) solo cuando quieras permitir eliminaciones o ejecución.

Desarrollo

npm run dev        # watch mode
npm test           # unit tests for the security policy
npm run typecheck

Publicación

Este servidor incluye un server.json para el registro oficial de MCP y un mcpName para validar la propiedad de npm. Consulta PUBLISHING.md para publicar en npm y aparecer en el registro MCP, Smithery, Glama, Cursor y PulseMCP.

Licencia

MIT