AKS-MCP

Herramienta: call_az (predeterminada, disponible cuando USE_LEGACY_TOOLS no está establecido o está establecido en false)

Herramienta unificada para ejecutar comandos de Azure CLI directamente. Esta herramienta proporciona una interfaz flexible para ejecutar cualquier comando de Azure CLI.

Parámetros:

• cli_command: El comando completo de Azure CLI a ejecutar (p. ej., az aks list --resource-group myRG, az vm list --subscription <sub-id>)
• timeout: Tiempo de espera opcional en segundos (predeterminado: 120)

Ejemplo de uso:

{
  "cli_command": "az aks list --resource-group myResourceGroup --output json"
}

Control de acceso:

• readonly: Solo se permiten operaciones de lectura
• readwrite/admin: Se permiten operaciones de lectura y escritura

Importante: Los comandos deben ser invocaciones simples de Azure CLI sin características de shell como tuberías (|), redirecciones (>, <), sustitución de comandos o punto y coma (;).

Herramienta: az_aks_operations (disponible cuando USE_LEGACY_TOOLS=true)

Herramienta unificada para gestionar clústeres de Azure Kubernetes Service (AKS) y operaciones relacionadas.

Operaciones disponibles:

• Solo lectura (todos los niveles de acceso):

  • show: Mostrar detalles del clúster
  • list: Listar clústeres en la suscripción/grupo de recursos
  • get-versions: Obtener versiones de Kubernetes disponibles
  • check-network: Realizar verificación de conectividad de red saliente
  • nodepool-list: Listar node pools en el clúster
  • nodepool-show: Mostrar detalles del node pool
  • account-list: Listar suscripciones de Azure

• Lectura-escritura (niveles de acceso readwrite/admin):

  • create: Crear nuevo clúster
  • delete: Eliminar clúster
  • scale: Escalar el número de nodos del clúster
  • start: Iniciar un clúster detenido
  • stop: Detener un clúster en ejecución
  • update: Actualizar la configuración del clúster
  • upgrade: Actualizar la versión de Kubernetes
  • nodepool-add: Agregar node pool al clúster
  • nodepool-delete: Eliminar node pool
  • nodepool-scale: Escalar node pool
  • nodepool-upgrade: Actualizar node pool
  • account-set: Establecer suscripción activa
  • login: Autenticación de Azure

• Solo administrador (nivel de acceso admin):

  • get-credentials: Obtener credenciales del clúster para acceso con kubectl

Herramienta: aks_network_resources

Herramienta unificada para obtener información de recursos de red de Azure utilizados por clústeres de AKS.

Tipos de recursos disponibles:

• all: Obtener información sobre todos los recursos de red
• vnet: Información de Virtual Network
• subnet: Información de Subnet
• nsg: Información de Network Security Group
• route_table: Información de Route Table
• load_balancer: Información de Load Balancer
• private_endpoint: Información de private endpoint

Herramienta: aks_monitoring

Herramienta unificada para operaciones de monitoreo y diagnóstico de Azure para clústeres de AKS.

Operaciones disponibles:

• metrics: Listar valores de métricas para recursos
• resource_health: Recuperar eventos de estado de recursos para clústeres de AKS
• app_insights: Ejecutar consultas KQL contra datos de telemetría de Application Insights
• diagnostics: Verificar si el clúster de AKS tiene configurados ajustes de diagnóstico
• control_plane_logs: Consultar registros del plano de control de AKS con restricciones de seguridad y validación de rango de tiempo

Herramienta: get_aks_vmss_info

• Obtener configuración detallada de VMSS para node pools en el clúster de AKS

Herramienta: collect_aks_node_logs

Recopilar registros del sistema de nodos VMSS de AKS para depuración y resolución de problemas.

Parámetros:

• aks_resource_id: ID de recurso del clúster de AKS
• vmss_name: Nombre del VMSS (obtener de get_aks_vmss_info o kubectl get nodes)
• instance_id: ID de instancia del VMSS
• log_type: Tipo de registros a recopilar (kubelet, containerd, kernel, syslog)
• lines: Número de líneas de registro recientes a devolver (predeterminado: 500, máximo: 2000)
• since: Rango de tiempo para los registros (p. ej., 1h, 30m, 2d) - tiene prioridad sobre lines
• level: Filtro de nivel de registro (ERROR, WARN, INFO)
• filter: Filtrar registros por palabra clave (coincidencia de texto sin distinción de mayúsculas/minúsculas)

Ejemplo de uso:

{
  "aks_resource_id": "/subscriptions/.../managedClusters/myAKS",
  "vmss_name": "aks-nodepool1-12345678-vmss",
  "instance_id": "0",
  "log_type": "kubelet",
  "since": "1h",
  "level": "ERROR",
  "filter": "ImagePullBackOff"
}

Limitaciones:

• Solo admite nodos VMSS de Linux (los nodos de Windows y las VM independientes aún no son compatibles)
• Solo se puede ejecutar un comando a la vez por instancia de VMSS

Herramienta: az_compute_operations Herramienta unificada para gestionar Azure Virtual Machines (VMs) y Virtual Machine Scale Sets (VMSS) utilizados por AKS.

Operaciones disponibles:

• show: Obtener detalles de una VM/VMSS
• list: Listar VMs/VMSS en la suscripción o grupo de recursos
• get-instance-view: Obtener estado de ejecución
• start: Iniciar VM
• stop: Detener VM
• restart: Reiniciar instancias de VM/VMSS
• reimage: Reimage instancias de VMSS (VM no soporta reimage)

Tipos de recursos: vm (máquinas virtuales individuales), vmss (conjuntos de escala de máquinas virtuales)

Herramienta: az_fleet

Gestión integral de flotas de Azure para escenarios de múltiples clústeres.

Operaciones disponibles:

• Operaciones de flota: listar, mostrar, crear, actualizar, eliminar, obtener credenciales
• Operaciones de miembro: listar, mostrar, crear, actualizar, eliminar
• Operaciones de ejecución de actualización: listar, mostrar, crear, iniciar, detener, eliminar
• Operaciones de estrategia de actualización: listar, mostrar, crear, eliminar
• Operaciones de ClusterResourcePlacement: listar, mostrar, obtener, crear, eliminar

Admite operaciones de gestión de flotas de Azure y de CRD de Kubernetes ClusterResourcePlacement.

Herramienta: aks_detector

Herramienta unificada para ejecutar operaciones de detectores de diagnóstico de AKS.

Operaciones disponibles:

• list: Listar todos los detectores de clúster AKS disponibles
• run: Ejecutar un detector de diagnóstico AKS específico
• run_by_category: Ejecutar todos los detectores en una categoría específica

Parámetros:

• operation (requerido): Operación a realizar (list, run o run_by_category)
• aks_resource_id (requerido): ID de recurso del clúster AKS
• detector_name (requerido para la operación run): Nombre del detector a ejecutar
• category (requerido para la operación run_by_category): Categoría del detector
• start_time (requerido para las operaciones run y run_by_category): Hora de inicio en formato ISO UTC (dentro de los últimos 30 días)
• end_time (requerido para las operaciones run y run_by_category): Hora de finalización en formato ISO UTC (dentro de los últimos 30 días, máximo 24h desde el inicio)

Categorías disponibles:

• Mejores prácticas
• Disponibilidad y rendimiento del clúster y plano de control
• Problemas de conectividad
• Crear, actualizar, eliminar y escalar
• Deprecaciones
• Identidad y seguridad
• Salud de nodos
• Almacenamiento

Ejemplo de uso:

{
  "operation": "list",
  "aks_resource_id": "/subscriptions/xxx/resourceGroups/xxx/providers/Microsoft.ContainerService/managedClusters/xxx"
}

{
  "operation": "run",
  "aks_resource_id": "/subscriptions/xxx/resourceGroups/xxx/providers/Microsoft.ContainerService/managedClusters/xxx",
  "detector_name": "node-health-detector",
  "start_time": "2025-01-15T10:00:00Z",
  "end_time": "2025-01-15T12:00:00Z"
}

Herramienta: aks_advisor_recommendation

Recuperar y gestionar recomendaciones de Azure Advisor para clústeres AKS.

Operaciones disponibles:

• list: Listar recomendaciones con opciones de filtrado
• report: Generar informes de recomendaciones
• Opciones de filtro: resource_group, cluster_names, categoría (Cost, HighAvailability, Performance, Security), severidad (High, Medium, Low)

Nota: Todas las herramientas de Kubernetes (kubectl, helm, cilium, hubble) están habilitadas por defecto. Use --enabled-components para habilitar selectivamente componentes específicos.

Herramienta kubectl unificada (predeterminada)

Herramienta: call_kubectl (predeterminada, disponible cuando USE_LEGACY_TOOLS no está configurado o está configurado como false)

Herramienta unificada para ejecutar comandos kubectl directamente. Esta herramienta proporciona una interfaz flexible para ejecutar cualquier comando kubectl con soporte completo de argumentos.

Parámetros:

• args: Los argumentos del comando kubectl (por ejemplo, get pods, describe node mynode, apply -f deployment.yaml)

Ejemplo de uso:

{
  "args": "get pods -n kube-system -o wide"
}

Control de acceso: Las operaciones están restringidas según el nivel de acceso configurado:

• readonly: Solo se permiten operaciones de lectura (get, describe, logs, etc.)
• readwrite/admin: Todas las operaciones, incluidos los comandos de mutación (create, delete, apply, etc.)

Herramientas kubectl heredadas (especializadas)

Disponibles cuando USE_LEGACY_TOOLS=true:

• Solo lectura (todos los niveles de acceso):

  • kubectl_resources: Ver recursos (get, describe) - filtrado a operaciones de solo lectura en modo readonly
  • kubectl_diagnostics: Depurar y diagnosticar (logs, events, top, exec, cp)
  • kubectl_cluster: Información del clúster (cluster-info, api-resources, api-versions, explain)
  • kubectl_config: Gestión de configuración (diff, auth, config) - filtrado a operaciones de solo lectura en modo readonly

• Lectura-escritura/Admin (niveles de acceso readwrite/admin):

  • kubectl_resources: Gestión completa de recursos (get, describe, create, delete, apply, patch, replace, cordon, uncordon, drain, taint)
  • kubectl_workloads: Ciclo de vida de cargas de trabajo (run, expose, scale, autoscale, rollout)
  • kubectl_metadata: Gestión de metadatos (label, annotate, set)
  • kubectl_config: Gestión completa de configuración (diff, auth, certificate, config)

Helm

Herramienta: call_helm

Gestor de paquetes Helm para Kubernetes.

Cilium

Herramienta: call_cilium

CLI de Cilium para redes y seguridad basadas en eBPF.

Hubble

Herramienta: call_hubble

Observabilidad de red de Hubble para Cilium.

Herramienta: inspektor_gadget_observability

Herramienta de observabilidad en tiempo real para clústeres de Azure Kubernetes Service (AKS) que utiliza eBPF.

Acciones disponibles:

• deploy: Implementar Inspektor Gadget en el clúster (a través de la extensión de clúster AKS)
• undeploy: Eliminar la extensión de clúster Inspektor Gadget del clúster
• is_deployed: Verificar el estado de implementación
• run: Ejecutar gadgets de un solo uso
• start: Iniciar gadgets continuos
• stop: Detener gadgets en ejecución
• get_results: Recuperar resultados de gadgets
• list_gadgets: Listar gadgets disponibles

Gadgets disponibles:

• observe_dns: Monitorear solicitudes y respuestas DNS
• observe_tcp: Monitorear conexiones TCP
• observe_file_open: Monitorear operaciones del sistema de archivos
• observe_process_execution: Monitorear ejecución de procesos
• observe_signal: Monitorear entrega de señales
• observe_system_calls: Monitorear llamadas al sistema
• top_file: Archivos principales por operaciones de E/S
• top_tcp: Conexiones TCP principales por tráfico
• tcpdump: Capturar paquetes de red

La forma más fácil de comenzar con AKS-MCP es a través de la Extensión de Azure Kubernetes Service para VS Code.

Paso 1: Instalar la extensión AKS

1. Abra VS Code y vaya a Extensiones (Ctrl+Shift+X en Windows/Linux o Cmd+Shift+X en macOS).
2. Busque Azure Kubernetes Service.
3. Instale la extensión oficial de Microsoft AKS.

Paso 2: Iniciar el servidor AKS-MCP

1. Abra la Paleta de comandos (Ctrl+Shift+P en Windows/Linux o Cmd+Shift+P en macOS).
2. Busque y ejecute: AKS: Setup AKS MCP Server.

Tras una instalación exitosa, el servidor ahora será visible en MCP: List Servers (a través de la Paleta de comandos). Desde allí, puede iniciar el servidor MCP o ver su estado.

Paso 3: Comenzar a usar AKS-MCP

Una vez iniciado, el servidor MCP aparecerá en el menú desplegable Copilot Chat: Configure Tools bajo MCP Server: AKS MCP, listo para mejorar las indicaciones contextuales basadas en su entorno AKS. De forma predeterminada, todas las herramientas del servidor AKS-MCP están habilitadas. Puede revisar la lista de herramientas disponibles y deshabilitar las que no sean necesarias para su escenario específico.

Pruebe una indicación como "List all my AKS clusters", que comenzará a usar herramientas del servidor AKS-MCP.

Configuración de WSL

La configuración de MCP difiere según si VS Code se ejecuta en Windows o dentro de WSL:

🪟 Host de Windows (VS Code en Windows): Use "command": "wsl" para invocar el binario de WSL desde Windows:

{
  "servers": {
    "aks-mcp": {
      "type": "stdio",
      "command": "wsl",
      "args": [
        "--",
        "/home/you/.vs-kubernetes/tools/aks-mcp/aks-mcp"
      ]
    }
  }
}

🐧 Remote-WSL (VS Code ejecutándose dentro de WSL): Llame al binario directamente o use un envoltorio de shell:

{
  "servers": {
    "aks-mcp": {
      "type": "stdio",
      "command": "bash",
      "args": [
        "-c",
        "/home/you/.vs-kubernetes/tools/aks-mcp/aks-mcp"
      ]
    }
  }
}

🔧 Solución de problemas de errores ENOENT

Si ve errores de "spawn ENOENT", verifique su entorno de VS Code:

• Host de Windows: Verifique si la ruta del binario de WSL es correcta y accesible a través de wsl -- ls /path/to/aks-mcp
• Remote-WSL: NO use "command": "wsl" - use rutas directas o envoltorio bash como se muestra arriba

Paso 1: Descargar el binario

Elija su plataforma y descargue el último binario de AKS-MCP:

Paso 2: Configurar VS Code

Después de descargar, cree un archivo .vscode/mcp.json en la raíz de su espacio de trabajo con la ruta a su binario descargado.

Opción A: Script de configuración automatizado

Para una configuración rápida, puede usar estos scripts de una línea que descargan el binario y crean la configuración:

Windows (PowerShell):

# Download binary and create VS Code configuration
mkdir -p .vscode ; Invoke-WebRequest -Uri "https://github.com/Azure/aks-mcp/releases/latest/download/aks-mcp-windows-amd64.exe" -OutFile "aks-mcp.exe" ; @{servers=@{"aks-mcp-server"=@{type="stdio";command="$PWD\aks-mcp.exe";args=@()}}} | ConvertTo-Json -Depth 3 | Out-File ".vscode/mcp.json" -Encoding UTF8

macOS/Linux (Bash):

# Download binary and create VS Code configuration
mkdir -p .vscode && curl -sL https://github.com/Azure/aks-mcp/releases/latest/download/aks-mcp-linux-amd64 -o aks-mcp && chmod +x aks-mcp && echo '{"servers":{"aks-mcp-server":{"type":"stdio","command":"'$PWD'/aks-mcp","args":[]}}}' > .vscode/mcp.json

Opción B: Configuración manual

✨ Configuración simple: Descargue el binario para su plataforma y luego use la configuración manual a continuación para configurar el servidor MCP en VS Code.

Configuración manual de VS Code

Puede configurar el servidor AKS-MCP de dos maneras:

1. Configuración específica del espacio de trabajo (recomendada para uso específico del proyecto):

Cree un archivo .vscode/mcp.json en su espacio de trabajo con la ruta a su binario descargado:

{
  "servers": {
    "aks-mcp-server": {
      "type": "stdio",
      "command": "<enter the file path>",
      "args": []
    }
  }
}

2. Configuración a nivel de usuario (persistente en todos los espacios de trabajo):

Para una configuración persistente que funcione en todos sus espacios de trabajo de VS Code, agregue el servidor MCP a la configuración de usuario de VS Code:

1. Abra la configuración de VS Code (Ctrl+, o Cmd+,)
2. Busque "mcp" en la configuración
3. Agregue lo siguiente al JSON de configuración de usuario:

{
  "github.copilot.chat.mcp.servers": {
    "aks-mcp-server": {
      "type": "stdio",
      "command": "<enter the file path>",
      "args": []
    }
  }
}

Paso 3: Cargar las herramientas del servidor AKS-MCP en GitHub Copilot

1. Si está ejecutando una versión anterior de VS Code: reinicie VS Code, es decir, cierre y vuelva a abrir VS Code para cargar la nueva configuración del servidor MCP.
2. Abra GitHub Copilot en VS Code y cambie al modo Agente
3. Haga clic en el botón Tools o ejecute /list en la ventana de GitHub Copilot para ver la lista de herramientas disponibles
4. Debería ver las herramientas de AKS-MCP en la lista
5. Pruebe una indicación como: "List all my AKS clusters in subscription xxx"
6. El agente usará automáticamente las herramientas de AKS-MCP para completar su solicitud

💡 Consejo: Si no ve las herramientas de AKS-MCP después de reiniciar, revise el panel de salida de VS Code para ver si hay errores de conexión del servidor MCP y verifique su ruta de binario en .vscode/mcp.json.

Nota: Asegúrese de haberse autenticado con Azure CLI (az login) para que el servidor acceda a sus recursos de Azure.

Para otros clientes de IA compatibles con MCP como Claude Desktop o GitHub Copilot CLI, configure el servidor en su configuración de MCP:

{
  "mcpServers": {
    "aks": {
      "command": "<path of binary aks-mcp>",
      "args": []
    }
  }
}

🤖 Instalación de cliente MCP personalizado

Puede configurar cualquier cliente compatible con MCP para usar el servidor AKS-MCP ejecutando el binario directamente:

# Run the server directly
./aks-mcp

🔧 Instalación Manual del Binario

Para uso directo del binario sin gestores de paquetes:

1. Descargue la última versión desde la página de versiones
2. Extraiga el binario a la ubicación de su preferencia
3. Hágalo ejecutable (en sistemas Unix):

   chmod +x aks-mcp
   

4. Configure su cliente MCP para usar la ruta del binario