Cómo Usar Amazon EKS MCP Server: Guía Paso a Paso

¿Quieres potenciar tu juego en Kubernetes con IA? El Amazon EKS MCP Server es tu nuevo mejor amigo, permitiendo que asistentes de IA como Cline gestionen tus clústeres EKS con lenguaje natural. Lo puse en marcha en ~15 minutos, ¡y cambia totalmente las reglas del juego! En este tutorial, instalaremos el Amazon EKS MCP Server usando Cline en VS Code, crearemos un clúster, desplegaremos NGINX y solucionaremos problemas de pods, todo con un ambiente conversacional. ¡Sumérgete en la magia del Amazon EKS MCP Server!

💡

¿Quieres una excelente herramienta de prueba de API que genere hermosa documentación de API?

¿Quieres una plataforma integrada y todo en uno para que tu equipo de desarrolladores trabaje junto con máxima productividad?

Apidog satisface todas tus demandas y reemplaza a Postman a un precio mucho más asequible!

button

¿Qué es el Amazon EKS MCP Server?

El Amazon EKS MCP Server es una herramienta de código abierto que permite a los asistentes de código de IA (como Cline, Amazon Q o Cursor) gestionar clústeres de Amazon Elastic Kubernetes Service (EKS) a través del Protocolo de Contexto de Modelo (MCP). Proporciona información del clúster en tiempo real y automatiza tareas como la creación de clústeres, despliegues y resolución de problemas. Características clave:

Gestión de Clústeres: Crea y gestiona clústeres EKS con VPC y roles de IAM auto-configurados.
Control de Recursos: Maneja recursos de Kubernetes (pods, servicios, despliegues) a través de YAML o lenguaje natural.
Monitorización: Accede a logs de pods, métricas de CloudWatch y eventos para depuración.
Seguridad: Se ejecuta en modo de solo lectura por defecto, con acceso de escritura configurable.

El servidor eks mcp es una "superpotencia de Kubernetes" para DevOps impulsado por IA. ¿Listo para probarlo? ¡Vamos allá!

¿Por qué usar el Amazon EKS MCP Server?

El Amazon EKS MCP Server simplifica los flujos de trabajo complejos de EKS, haciéndolo perfecto para:

Principiantes: No necesitas dominar kubectl o eksctl; Cline hace el trabajo pesado.
Profesionales: Automatiza tareas repetitivas y enfócate en la innovación.
Equipos: Agiliza los despliegues con mejores prácticas consistentes.
Fanáticos de la IA: Aprovecha los LLMs para DevOps en lenguaje natural.

Lo usé para levantar un clúster y desplegar NGINX en minutos, ¡sin necesidad de ajustar YAML manualmente!

Cómo instalar y usar Amazon EKS MCP Server: Guía paso a paso

Nos centraremos en instalar el Amazon EKS MCP Server con Cline en VS Code, pero mencionaré brevemente la configuración manual. Necesitarás Python 3.10+, AWS CLI y VS Code. ¡Comencemos!

1. Requisitos previos

Python: 3.10+ (python3 --version).
AWS CLI: Configurado con permisos de EKS (aws sts get-caller-identity).
VS Code: Última versión con la extensión Cline.
Cuenta de AWS: Con roles de IAM para EKS, VPC y CloudFormation.
kubectl: Para ver pods (kubectl version).
uv: Gestor de paquetes de Python (pip install uv).

2. Instalación manual (Vista rápida)

Para una configuración manual, clona el repositorio e instala a través de uv:

git clone https://github.com/awslabs/mcp.git
cd mcp/src/eks-mcp-server
uv pip install awslabs.eks-mcp-server
uv run main.py

Configura las credenciales de AWS en ~/.aws/credentials y ejecuta el servidor. Pero usemos Cline para un camino más suave.

3. Instalar Cline en VS Code

Abre VS Code, ve a Extensiones (Ctrl+Shift+X) e instala Cline.
Verifica que Cline esté activo: Abre el panel de chat de Cline (Ctrl+Shift+P, busca "Cline: Open Chat").
Configura un proveedor de LLM (por ejemplo, AWS Bedrock u OpenAI) en la configuración de Cline (icono de engranaje > API Provider).

Usé AWS Bedrock para una integración perfecta con AWS, ¡tardé ~2 minutos!

4. Instalar Amazon EKS MCP Server con Cline

Abre el panel de chat de Cline en VS Code.
Pide a Cline:

# Prompt 1 (Básico)
Instalar eks-mcp-server de awslabs

# Prompt 2 (En detalle)
Instalar el servidor MCP llamado awslabs.eks-mcp-server para Cline. Usar uvx para ejecutar el servidor y actualizar la configuración de mcp.

Aprueba las acciones de Cline (por ejemplo, ejecutar uvx awslabs.eks-mcp-server@latest).
Cline actualiza ~/.aws/amazonq/mcp.json con:

{
  "mcpServers": {
    "awslabs.eks-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.eks-mcp-server@latest", "--allow-write"],
      "env": {
        "AWS_PROFILE": "default",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

Verifica: Ejecuta /tools en el chat de Cline para listar las herramientas de EKS MCP (por ejemplo, create_eks_cluster, apply_yaml).

Si encuentras errores (por ejemplo, "docker not found"), añade --allow-write a args y asegúrate de que eksctl esté instalado (brew install eksctl en macOS).

Para darle acceso a Cline a tu cuenta de AWS: Ejecuta aws configure en tu terminal e introduce tus credenciales.

Ocasionalmente, sería útil tener un servidor mcp de búsqueda web (por ejemplo, firecraw) instalado en tu Cline por si acaso Cline encuentra algún error y necesita navegar por la web para obtener ayuda. Puedes instalar estos fácilmente a través del mercado de mcp de Cline en Cline.

5. Crear un nuevo clúster EKS con Cline

En el chat de Cline, pide:

# prompt 1 (básico)
Ayuda a crear un nuevo clúster EKS

# prompt 2 (especificando parámetros)
Ayuda a crear un nuevo clúster EKS llamado 'my-ai-cluster' en us-east-1 usando el Amazon EKS MCP Server.

Cline utiliza la herramienta create_eks_cluster, auto-configurando VPC, subredes y roles de IAM.
Aprueba las acciones (por ejemplo, ejecutar eksctl create cluster).
Espera ~10 minutos para la creación del clúster. Verifica el estado:

eksctl get cluster --name my-ai-cluster --region us-east-1

Salida: my-ai-cluster está ACTIVE.

Mi clúster estuvo listo en 12 minutos, ¡Cline manejó todo!

6. Desplegar NGINX con Cline

Pide a Cline:

# Ejemplo de prompt
Preparar un archivo de despliegue para NGINX. Crear un manifiesto completo de Kubernetes que incluya tanto un despliegue como un servicio para NGINX usando el Amazon EKS MCP Server.

Cline genera un manifiesto usando la herramienta generate_app_manifest:

apiVersion: apps/v1
kind: Deployment
metadata:
  name: nginx-deployment
  namespace: default
spec:
  replicas: 3
  selector:
    matchLabels:
      app: nginx
  template:
    metadata:
      labels:
        app: nginx
    spec:
      containers:
      - name: nginx
        image: nginx:latest
        ports:
        - containerPort: 80
---
apiVersion: v1
kind: Service
metadata:
  name: nginx-service
  namespace: default
spec:
  selector:
    app: nginx
  ports:
  - protocol: TCP
    port: 80
    targetPort: 80
  type: LoadBalancer

Cline lo aplica con la herramienta apply_yaml. Aprueba la acción.
Verifica los pods:

kubectl get pods -A

Ejemplo de salida:

NAMESPACE  NAME                           READY  STATUS   RESTARTS  AGE
default    nginx-deployment-abc123-xyz    1/1    Running  0         2m

El YAML de Cline fue perfecto, ¡y mi servicio NGINX estuvo activo en ~3 minutos!

7. Solucionar problemas de pods con Cline

Si los pods muestran errores (por ejemplo, CrashLoopBackOff):

kubectl get pods -A

Salida:

NAMESPACE  NAME                           READY  STATUS            RESTARTS  AGE
default    nginx-deployment-abc123-xyz    0/1    CrashLoopBackOff  3         5m

Pide a Cline:

# Ejemplo de prompt
Descubrir el problema con mis pods y solucionarlo usando el Amazon EKS MCP Server.

Cline utiliza herramientas como get_pod_logs y get_k8s_events para diagnosticar (por ejemplo, etiqueta de imagen faltante).
Cline sugiere soluciones (por ejemplo, actualizar la imagen a nginx:1.25) y vuelve a aplicar el manifiesto.

Vuelve a verificar los pods:

kubectl get pods -A

Salida:

NAMESPACE  NAME                           READY  STATUS   RESTARTS  AGE
default    nginx-deployment-abc123-xyz    1/1    Running  0         1m

Cline solucionó el fallo de mi pod en segundos, ¡pura magia de IA!

Solución de problemas del Amazon EKS MCP Server

Errores de Cline: Asegúrate de que mcp.json tenga el AWS_PROFILE correcto y --allow-write para operaciones de escritura.
Problemas de Permisos: Verifica que los roles de IAM tengan permisos para EKS, VPC y CloudFormation.
Conflictos de Puerto: Verifica el puerto 3000:

lsof -i :3000
kill -9 [PID]

Fallos de Pods: Usa la herramienta search_eks_troubleshoot_guide de Cline o verifica los logs:

kubectl logs [nombre-del-pod]

¿Necesitas ayuda? Consulta awslabs.github.io/mcp para obtener consejos.

Personalización y extensión del Amazon EKS MCP Server

Mejora tu configuración:

Multi-Región: Configura múltiples AWS_REGION en mcp.json.
Herramientas Personalizadas: Añade herramientas al servidor a través del repositorio de MCP (github.com/awslabs/mcp).
Uso en Producción: Habilita el modo de solo lectura (ALLOW_WRITE=false) por seguridad.
Integración: Combina con servidores MCP de AWS CDK o Terraform para IaC.

Ajusté mi servidor para us-west-2, ¡tardé ~5 minutos!

Por qué el Amazon EKS MCP Server es un sueño para DevOps

El Amazon EKS MCP Server hace que la gestión de EKS se sienta como chatear con un gurú de DevOps. Sus flujos de trabajo impulsados por IA superan las configuraciones manuales de eksctl, aunque la configuración de Cline puede ser un poco complicada para los novatos. Comparado con Kubernetes puro, es un ahorro de tiempo enorme. La documentación de AWS MCP es una salvación.

¿Listo para dominar el Amazon EKS MCP Server? ¡Enciende Cline, despliega ese NGINX y comparte tus creaciones!

💡

button