Características

MCP 💬 prompt 🗂️ resource 🤖 tool

• 🗂️🤖 Listar contextos de Kubernetes
• 💬🤖 Lista de espacios de nombres de Kubernetes
• 🤖 Listar y obtener cualquier recurso de Kubernetes
  • incluye mapeos personalizados para recursos como pods, servicios, despliegues, pero se puede listar y recuperar cualquier recurso
• 🤖 Lista de nodos Kubernetes
• 💬 Lista de pods de Kubernetes
• 🤖 Obtener eventos de Kubernetes
• 🤖 Obtener los registros de los pods de Kubernetes
• 🤖 Ejecutar comando en el pod de Kubernetes

Navegar con el inspector

Para usar la última versión publicada con Inspector puedes ejecutar esto:

npx @modelcontextprotocol/inspector npx @strowk/mcp-k8s

Usar con Claude

El siguiente chat con Claude Desktop demuestra cómo se ve cuando se selecciona un contexto particular como recurso y luego se le pide que compruebe los registros del pod en busca de errores en el espacio de nombres kube-system:

Para utilizar este servidor MCP con Claude Desktop (o cualquier otro cliente) es posible que tenga que elegir qué forma de instalación utilizar.

Tiene varias opciones:

Uso de Smithery

Para instalar MCP K8S Go para Claude Desktop automáticamente a través de Smithery:

npx -y @smithery/cli install @strowk/mcp-k8s --client claude

Usando mcp-get

Para instalar MCP K8S Go for Claude Desktop automáticamente a través de mcp-get:

npx @michaellatman/mcp-get@latest install @strowk/mcp-k8s

Manualmente con binarios precompilados

Precompilados desde npm

Utilice esta opción si tiene npm instalado y desea utilizar binarios precompilados:

npm install -g @strowk/mcp-k8s

A continuación, compruebe la versión ejecutando mcp-k8s --version y si ésta imprime la versión instalada, puede proceder a añadir la configuración al archivo claude_desktop_config.json:

{ "mcpServers": { "mcp_k8s": { "command": "mcp-k8s", "args": [] } } }

o usando npx con cualquier cliente:

npx @strowk/mcp-k8s

Por ejemplo para Claude:

{ "mcpServers": { "mcp_k8s": { "command": "npx", "args": [ "@strowk/mcp-k8s" ] } }

Desde GitHub releases

Dirígete a GitHub releases y descarga la última versión para tu plataforma.

Descomprime el archivo, que contendrá un binario llamado mcp-k8s-go, pon ese binario en algún lugar de tu PATH y luego añade la siguiente configuración al archivo claude_desktop_config.json:

{ "mcpServers": { "mcp_k8s": { "command": "mcp-k8s-go", "args": [] } } }

Construir desde el código fuente

Necesitarás Golang instalado para construir este proyecto:

go get github.com/strowk/mcp-k8s-go go install github.com/strowk/mcp-k8s-go

y añade la siguiente configuración al archivo claude_desktop_config.json:

{ "mcpServers": { "mcp_k8s_go": { "command": "mcp-k8s-go", "args": [] } } }

Uso de Docker

Este servidor está construido y publicado en Docker Hub desde la versión 0.3.1-beta.2 con imágenes multi-arch disponibles para las arquitecturas linux/amd64 y linux/arm64.

Puede utilizar la última etiqueta f.e de la siguiente manera:

docker run -i -v ~/.kube/config:/home/nonroot/.kube/config --rm mcpk8s/server:latest

Los usuarios de Windows pueden necesitar sustituir ~/.kube/config por //c/Users/<username>/.kube/config al menos en Git Bash.

Para Claude:

{ "mcpServers": { "mcp_k8s_go": { "command": "docker", "args": [ "run", "-i", "-v", "~/.kube/config:/home/nonroot/.kube/config", "--rm", "mcpk8s/server:latest" ] } }

Variables de entorno y opciones de línea de comandos

El servidor MCP utiliza las siguientes variables de entorno:

• KUBECONFIG: Ruta a su archivo de configuración de Kubernetes (opcional, por defecto ~/.kube/config)

Se admiten las siguientes opciones de línea de comandos:

• --allowed-contexts=<ctx1,ctx2,...>: Lista separada por comas de los contextos de Kubernetes permitidos a los que pueden acceder los usuarios. Si no se especifica, se permiten todos los contextos.
• --help: Muestra información de ayuda
• --version: Mostrar información sobre la versión