Which integrations are available for this server?

Allows interaction with Helm, providing tools to list Helm releases in clusters. Allows interaction with Kubernetes clusters, providing tools to list pods, services, namespaces, get cluster info, and analyze component versions.

How do I use Kubernetes MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Kubernetes MCP Server list all pods in the default namespace" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Kubernetes MCP Server

by Portfolio-jaime

Overview Schema Related Servers Score Discussions

Local

🚀 Kubernetes MCP Server

License: MIT TypeScript Node.js Kubernetes MCP

Un servidor MCP (Model Context Protocol) que permite a Claude Desktop interactuar directamente con clusters de Kubernetes usando kubectl y helm. Proporciona herramientas para consultar pods, servicios, releases de Helm, analizar versiones y más.

✨ Características

🔌 Integración directa con Claude Desktop via MCP
🎯 6 herramientas especializadas para Kubernetes
🔒 Servidor HTTPS con certificados auto-generados
🐳 DevContainer completo con todas las herramientas
📊 Análisis de versiones y componentes desactualizados
🛠️ Soporte para múltiples clusters (minikube, EKS, GKE, etc.)

Related MCP server: K8s MCP Server

🛠️ Herramientas Disponibles

Herramienta	Descripción	Parámetros
`get_pods`	Lista pods del cluster	`namespace` (opcional)
`get_services`	Lista servicios	`namespace` (opcional)
`get_helm_releases`	Lista releases de Helm	`namespace` (opcional)
`get_cluster_info`	Información general del cluster	-
`get_namespaces`	Lista todos los namespaces	-
`analyze_versions`	Analiza versiones de componentes	`namespace`, `component` (opcionales)

🚀 Inicio Rápido

Prerrequisitos

Node.js 18+
Docker Desktop
VS Code con extensión Dev Containers
Acceso a un cluster Kubernetes

1. Clonar el Repositorio

git clone https://github.com/tu-usuario/k8s-mcp-server.git
cd k8s-mcp-server

2. Abrir en DevContainer

# En VS Code: Cmd+Shift+P → "Dev Containers: Reopen in Container"

3. Construir el Proyecto

npm install
npm run build

4. Configurar Claude Desktop

Crear archivo ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "k8s-versions": {
      "command": "node",
      "args": ["/ruta/al/proyecto/dist/index.js"],
      "env": {
        "KUBECONFIG": "/Users/tu-usuario/.kube/config"
      }
    }
  }
}

5. Reiniciar Claude Desktop

# Cerrar Claude Desktop completamente y volver a abrir

📖 Documentación

📚 Guías Principales

Guía Rápida - Empezar en 5 minutos
Setup HTTPS - Configuración completa con servidor HTTPS
Configuración - Opciones avanzadas
API Reference - Documentación técnica completa

🎯 Ejemplos de Uso

Ejemplos Prácticos - Casos de uso reales

🏗️ Arquitectura

graph LR
    A[Claude Desktop] -->|MCP Protocol| B[MCP Server]
    B -->|kubectl| C[Kubernetes API]
    B -->|helm| D[Helm Charts]
    C --> E[Pods/Services/etc]
    D --> F[Releases]

🧪 Desarrollo

Scripts Disponibles

# Desarrollo
npm run dev              # Modo desarrollo con watch
npm run build           # Construir proyecto
npm run start           # Iniciar servidor MCP (stdio)

# Servidores HTTP/HTTPS
npm run start:http      # Servidor HTTP (puerto 3002)
npm run start:https     # Servidor HTTPS (puerto 3002)

# Testing
npm test               # Ejecutar tests
npm run test:coverage  # Tests con coverage
./scripts/test-mcp-https.sh  # Test completo del servidor HTTPS

# Calidad de código
npm run lint           # Linter
npm run type-check     # Verificación de tipos
npm run validate       # Lint + tipos + tests

Estructura del Proyecto

📁 k8s-mcp-server/
├── 📁 src/                 # Código fuente TypeScript
│   ├── index.ts           # Servidor MCP principal (stdio)
│   ├── https-server.ts    # Servidor HTTPS para desarrollo
│   └── 📁 services/       # Servicios de Kubernetes y Helm
├── 📁 scripts/            # Scripts de utilidad
├── 📁 docs/              # Documentación completa
├── 📁 .devcontainer/     # Configuración DevContainer
└── 📁 dist/              # Código compilado

🎮 Ejemplos de Uso en Claude Desktop

Una vez configurado, puedes hacer preguntas como:

¿Qué pods tengo corriendo en mi cluster?

Muéstrame los releases de Helm instalados

Dame información general de mi cluster de Kubernetes

¿Hay algún problema con los pods en el namespace kube-system?

Analiza las versiones de mis componentes y dime cuáles están desactualizados

🐳 DevContainer

El proyecto incluye un DevContainer completo con:

✅ Node.js 18 + TypeScript
✅ kubectl, helm, minikube
✅ Docker-in-Docker
✅ VS Code extensions para Kubernetes
✅ Scripts de configuración automática

Usar el DevContainer

Instalar VS Code + extensión "Dev Containers"
Abrir el proyecto en VS Code
Cmd+Shift+P → "Dev Containers: Reopen in Container"
Esperar a que se construya (primera vez ~5-10 min)
Ejecutar ./scripts/start-mcp-http.sh

🔧 Configuración Avanzada

Variables de Entorno

# Configuración de Kubernetes
KUBECONFIG=/path/to/kubeconfig
KUBECTL_NAMESPACE=default

# Configuración del servidor
PORT=3002
NODE_ENV=production

# Configuración de Minikube (DevContainer)
MINIKUBE_DRIVER=docker
MINIKUBE_MEMORY=4096
MINIKUBE_CPUS=2

Múltiples Clusters

Puedes configurar múltiples servidores MCP para diferentes clusters:

{
  "mcpServers": {
    "k8s-production": {
      "command": "node",
      "args": ["/ruta/al/proyecto/dist/index.js"],
      "env": {
        "KUBECONFIG": "/path/to/prod-kubeconfig"
      }
    },
    "k8s-staging": {
      "command": "node", 
      "args": ["/ruta/al/proyecto/dist/index.js"],
      "env": {
        "KUBECONFIG": "/path/to/staging-kubeconfig"
      }
    }
  }
}

🧪 Testing

Tests Automatizados

# Tests unitarios
npm test

# Tests de integración
npm run test:coverage

# Test del servidor HTTPS
./scripts/test-mcp-https.sh

# Test completo del MCP
./scripts/test-mcp.sh

Test Manual

# Probar herramientas MCP directamente
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/index.js

# Probar herramienta específica
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "get_pods", "arguments": {}}}' | node dist/index.js

🚨 Troubleshooting

Problemas Comunes

Claude Desktop no detecta el MCP

# Verificar archivo de configuración
ls ~/Library/Application\ Support/Claude/claude_desktop_config.json

# Verificar que el MCP funcione
echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/list"}' | node dist/index.js

# Reiniciar Claude Desktop
pkill -f "Claude" && sleep 3

Error de conectividad con Kubernetes

# Verificar conectividad
kubectl cluster-info
kubectl get nodes

# Verificar configuración
echo $KUBECONFIG
kubectl config current-context

Problemas con el DevContainer

# Reconstruir container
# En VS Code: Cmd+Shift+P → "Dev Containers: Rebuild Container"

# Verificar herramientas
which kubectl helm minikube node

📊 Casos de Uso

Para DevOps Engineers

Monitoreo rápido de clusters desde Claude Desktop
Análisis de versiones y components desactualizados
Troubleshooting interactivo con IA

Para Desarrolladores

Consultas rápidas sobre deployments
Verificación de servicios y pods
Análisis de configuraciones Helm

Para SREs

Auditoría de clusters y versions
Detección de problems con IA assistance
Documentación automática de infraestructura

🤝 Contribuir

Fork el proyecto
Crear feature branch: git checkout -b feature/nueva-funcionalidad
Commit cambios: git commit -am 'Agregar nueva funcionalidad'
Push al branch: git push origin feature/nueva-funcionalidad
Crear Pull Request

Desarrollo Local

# Instalar dependencias
npm install

# Desarrollo con auto-reload
npm run dev

# Ejecutar tests
npm test

# Lint código
npm run lint

📄 Licencia

Este proyecto está bajo la Licencia MIT - ver el archivo LICENSE para detalles.

🙏 Agradecimientos

Model Context Protocol por el protocolo MCP
Anthropic por Claude Desktop
Kubernetes y Helm por las herramientas
Comunidad open source por las librerías utilizadas

📞 Soporte

Issues: GitHub Issues
Discussions: GitHub Discussions
Documentation: /docs

¿Te gusta este proyecto? ⭐ Dale una estrella en GitHub!

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Portfolio-jaime/mcp-server-k8s'

If you have feedback or need assistance with the MCP directory API, please join our Discord server