aks-mcp

Overview

AKS-MCP is a well-structured MCP server that bridges AI assistants with Azure Kubernetes Service. It provides comprehensive tools for managing AKS clusters, including CRUD operations, retrieving network resources, monitoring, and diagnostics. The server supports multiple authentication methods including service principals, managed identities, and federated tokens, making it flexible for different enterprise security requirements.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• call_azcli_command: string, timeout?: number

  Unified tool for executing Azure CLI commands directly

  Try:List AKS clusters in my resource groupTry:Show details of a specific VMSS in my subscription
• aks_network_resourcesresource_type: string

  Get information about Azure network resources used by AKS clusters

  Try:Show the virtual network details for my AKS clusterTry:List all network security groups in my AKS cluster
• aks_monitoringoperation: string, ...parameters?

  Azure monitoring and diagnostics operations for AKS clusters

  Try:Get resource health events for my AKS clusterTry:Check diagnostic settings for my AKS cluster
• collect_aks_node_logsaks_resource_id: string, vmss_name: string, instance_id: string, log_type: string, lines?: number, since?: string, level?: string, filter?: string

  Collect system logs from AKS VMSS nodes for debugging

  Try:Get kubelet logs from my AKS cluster nodeTry:Show recent error logs for my AKS nodes
• aks_detectoroperation: string, aks_resource_id: string, detector_name?: string, category?: string, start_time?: string, end_time?: string

  Execute AKS diagnostic detector operations

  Try:List all available detectors for my AKS clusterTry:Run node health detector for my AKS cluster
• aks_advisor_recommendationoperation: string, ...parameters?

  Retrieve and manage Azure Advisor recommendations for AKS clusters

  Try:Show high severity recommendations for my AKS clusterTry:Generate a cost optimization report for my AKS clusters
• call_kubectlargs: string

  Unified tool for executing kubectl commands directly

  Try:List all pods in the kube-system namespaceTry:Describe the deployment my-app
• call_helm

  Helm package manager for Kubernetes

  Try:List all releases in my clusterTry:Install a new chart from my-repo/my-chart
• az_fleet

  Comprehensive Azure Fleet management for multi-cluster scenarios

  Try:List all Azure Fleets in my subscriptionTry:Create a new Fleet with my AKS clusters
• az_compute_operationsoperation: string, resource_type: string, ...parameters?

  Manage Azure Virtual Machines and Virtual Machine Scale Sets

  Try:List all VMSS in my resource groupTry:Restart VMSS instances in my AKS cluster
• get_aks_vmss_info

  Get detailed VMSS configuration for node pools in AKS cluster

  Try:Show VMSS details for my AKS nodepoolTry:Get configuration of VMSS instances in my cluster
• az_aks_operations

  Legacy tool for managing Azure Kubernetes Service clusters

  Try:Create a new AKS cluster in my resource groupTry:Scale the node count of my existing AKS cluster

Comparable tools

Installation

go install github.com/Azure/aks-mcp@latest

{
  "mcpServers": {
    "aks-mcp": {
      "command": "aks-mcp",
      "args": ["--transport", "stdio", "--access-level", "readwrite"]
    }
  }
}

FAQ

What authentication methods are supported?

AKS-MCP supports service principal (client secret), workload identity (federated token), user-assigned managed identity, system-assigned managed identity, and existing Azure CLI login.

What permissions are required for the AKS-MCP server?

By default, only read permissions are required. For read-write or admin operations, you need to specify the access level parameter in your MCP configuration.

Compare aks-mcp with