local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Allows viewing and managing Kubernetes resources including configuration, generic resources, and pods. Supports operations like CRUD on any Kubernetes resource, listing/getting/deleting pods, showing pod logs, and running container images.

Servidor MCP de Kubernetes

✨ Características | 🚀 Primeros pasos | 🎥 Demostraciones | ⚙️ Configuración | 🧑‍💻 Desarrollo

https://github.com/user-attachments/assets/be2b67b3-fc1c-4d11-ae46-93deba8ed98e

✨ Características

Una implementación de servidor de Protocolo de contexto de modelo (MCP) de Kubernetes potente y flexible con soporte para Kubernetes y OpenShift .

✅ Configuración :
- Detecta automáticamente cambios en la configuración de Kubernetes y actualiza el servidor MCP.
- Ver y administrar la configuración actual de Kubernetes .kube/config o en el clúster.
✅ Recursos genéricos de Kubernetes : realice operaciones en cualquier recurso de Kubernetes o OpenShift.
- Cualquier operación CRUD (Crear o actualizar, obtener, enumerar, eliminar).
✅ Pods : Realiza operaciones específicas de Pod.
- Enumere los pods en todos los espacios de nombres o en un espacio de nombres específico.
- Obtener un pod por nombre del espacio de nombres especificado.
- Eliminar un pod por nombre del espacio de nombres especificado.
- Mostrar registros de un pod por nombre desde el espacio de nombres especificado.
- Ejecútelo en un pod y ejecute un comando.
- Ejecute una imagen de contenedor en un pod y, opcionalmente, expóngala.
✅ Espacios de nombres : enumera los espacios de nombres de Kubernetes.
✅ Eventos : vea eventos de Kubernetes en todos los espacios de nombres o en un espacio de nombres específico.
✅ Proyectos : Lista de proyectos de OpenShift.

A diferencia de otras implementaciones de servidor MCP de Kubernetes, esto NO ES solo un envoltorio para las herramientas de línea de comandos kubectl o helm .

NO es necesario instalar dependencias ni herramientas externas en el sistema. Si usas los binarios nativos, ni siquiera necesitas tener instalado Node ni Python.

🚀 Primeros pasos

Requisitos

Acceso a un clúster de Kubernetes.

Escritorio de Claude

Usando npx

Si tiene npm instalado, esta es la forma más rápida de comenzar a utilizar kubernetes-mcp-server en Claude Desktop.

Abra su claude_desktop_config.json y agregue el servidor mcp a la lista de mcpServers :

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

VS Code / VS Code Insiders

Instale la extensión del servidor Kubernetes MCP en VS Code Insiders presionando el siguiente enlace:

Alternativamente, puede instalar la extensión manualmente ejecutando el siguiente comando:

# For VS Code
code --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'
# For VS Code Insiders
code-insiders --add-mcp '{"name":"kubernetes","command":"npx","args":["kubernetes-mcp-server@latest"]}'

Goose CLI

Goose CLI es la forma más sencilla (y económica) de comenzar a trabajar con agentes de inteligencia artificial (IA).

Usando npm

Si tiene npm instalado, esta es la forma más rápida de comenzar a utilizar kubernetes-mcp-server .

Abra su goose config.yaml y agregue el servidor mcp a la lista de mcpServers :

extensions:
  kubernetes:
    command: npx
    args:
      - -y
      - kubernetes-mcp-server@latest

🎥 Demos

Diagnóstico y reparación automática de una implementación de OpenShift

Demostración que muestra cómo Claude Desktop aprovecha el servidor Kubernetes MCP para diagnosticar y reparar automáticamente una implementación en OpenShift sin asistencia del usuario.

https://github.com/user-attachments/assets/a576176d-a142-4c19-b9aa-a83dc4b8d941

Vibe Codificación de un juego simple e implementación en OpenShift

En esta demostración, lo guiaré a través del proceso de codificación de un juego simple usando VS Code y cómo aprovechar el servidor MCP de Podman y el servidor MCP de Kubernetes para implementarlo en OpenShift.

⚙️ Configuración

El servidor Kubernetes MCP se puede configurar mediante argumentos de la línea de comandos (CLI).

Puede ejecutar el ejecutable CLI utilizando npx o descargando el binario de la última versión .

# Run the Kubernetes MCP server using npx (in case you have npm installed)
npx kubernetes-mcp-server@latest --help

# Run the Kubernetes MCP server using the latest release binary
./kubernetes-mcp-server --help

Opciones de configuración

Opción	Descripción
`--sse-port`	Inicia el servidor MCP en modo de evento enviado por el servidor (SSE) y escucha en el puerto especificado.
`--log-level`	Establece el nivel de registro (valores de 0 a 9 ). Similar a los niveles de registro de kubectl .

🧑‍💻 Desarrollo

Ejecutando con mcp-inspector

Compile el proyecto y ejecute el servidor MCP de Kubernetes con mcp-inspector para inspeccionar el servidor MCP.

# Compile the project
make build
# Run the Kubernetes MCP server with mcp-inspector
npx @modelcontextprotocol/inspector@latest $(pwd)/kubernetes-mcp-server

This server cannot be installed

-

security - not tested

A

license - permissive license

-

quality - not tested

Una implementación de servidor Kubernetes MCP potente y flexible con soporte para OpenShift.

Related Resources

Reddit Discussion about this server