mcp/aks

Azure Kubernetes Service (AKS) MCP服务器

Azure Kubernetes Service (AKS)官方MCP服务器。

什么是MCP服务器？

MCP信息

镜像构建信息

可用工具（15种）

---

工具详情

工具：az_advisor_recommendation

获取和管理AKS集群的Azure Advisor建议

此工具可能执行破坏性更新。

此工具与外部实体交互。

---

工具：az_aks_operations

用于管理Azure Kubernetes Service (AKS)集群及相关操作的统一工具。

支持的操作：

• 集群：show（显示）、list（列出）、get-versions（获取版本）、check-network（检查网络）
• 节点池：nodepool-list（列出节点池）、nodepool-show（显示节点池）
• 账户：account-list（列出账户）

示例：

• 显示集群：operation="show", args="--name myCluster --resource-group myRG"
• 列出节点池：operation="nodepool-list", args="--cluster-name myCluster --resource-group myRG"

此工具可能执行破坏性更新。

此工具与外部实体交互。

---

工具：az_compute_operations

使用Azure CLI管理Azure虚拟机(VM)和虚拟机规模集(VMSS)的统一工具。

重要提示：VM/VMSS资源由AKS管理。写入操作应谨慎使用，仅用于调试目的。

使用resource_type="vm"表示单个虚拟机，resource_type="vmss"表示虚拟机规模集。

可用操作值：

• show：获取VM/VMSS的详细信息
• list：列出订阅或资源组中的VM/VMSS
• get-instance-view：获取运行时状态

示例：

• 列出VMSS：operation="list", resource_type="vmss", args="--resource-group myRG"
• 显示VMSS：operation="show", resource_type="vmss", args="--name myVMSS --resource-group myRG"
• 列出VM：operation="list", resource_type="vm", args="--resource-group myRG"

此工具可能执行破坏性更新。

此工具与外部实体交互。

---

工具：az_fleet

运行Azure Kubernetes Service Fleet管理命令。

可用操作和资源：

• fleet：list（列出）、show（显示）、create（创建）、update（更新）、delete（删除）、get-credentials（获取凭据）
• member：list（列出）、show（显示）、create（创建）、update（更新）、delete（删除）
• updaterun：list（列出）、show（显示）、create（创建）、start（启动）、stop（停止）、delete（删除）
• updatestrategy：list（列出）、show（显示）、create（创建）、delete（删除）
• clusterresourceplacement：list（列出）、show（显示）、get（获取）、create（创建）、delete（删除）（Kubernetes CRD操作）

示例：

• 列出fleet：operation='list', resource='fleet', args='--resource-group myRG'
• 显示fleet：operation='show', resource='fleet', args='--name myFleet --resource-group myRG'
• 获取fleet凭据：operation='get-credentials', resource='fleet', args='--name myFleet --resource-group myRG'
• 创建成员：operation='create', resource='member', args='--name myMember --fleet-name myFleet --resource-group myRG --member-cluster-id /subscriptions/.../myCluster'
• 创建clusterresourceplacement：operation='create', resource='clusterresourceplacement', args='--name nginx --selector app=nginx --policy PickAll'
• 列出clusterresourceplacement：operation='list', resource='clusterresourceplacement', args=''

此工具可能执行破坏性更新。

此工具与外部实体交互。

---

工具：az_monitoring

用于AKS集群的Azure监控和诊断操作的统一工具。

支持的操作：

1. 指标 - 查询AKS集群和节点的Azure Monitor指标

   • list：获取特定指标的指标值
   • list-definitions：获取资源可用的指标
   • list-namespaces：获取指标命名空间

   用途：CPU使用率、内存消耗、网络流量、Pod数量、节点健康状况 必需参数：resource（Azure资源ID） 'list'操作附加参数：metrics（指标名称） 可选参数：aggregation（聚合方式）、start-time（开始时间）、end-time（结束时间）、interval（间隔）、filter（筛选器）

2. 资源健康 - 获取AKS集群的Azure资源健康事件 用途：集群可用性问题、平台问题、服务健康事件 必需参数：subscription_id（订阅ID）、resource_group（资源组）、cluster_name（集群名称）、start_time（开始时间） 可选参数：end_time（结束时间）、status（状态：Available（可用）、Unavailable（不可用）、Degraded（降级）、Unknown（未知））

3. Application Insights - 对Application Insights遥测执行KQL查询 用途：应用性能监控、自定义遥测分析、跟踪关联 必需参数：subscription_id（订阅ID）、resource_group（资源组）、app_insights_name（Application Insights名称）、query（查询语句） 可选参数：start_time + end_time（开始时间+结束时间）或timespan（时间跨度）（不可同时使用）

4. 诊断 - 检查AKS集群诊断设置配置 用途：验证日志是否启用、检查日志保留期、验证诊断配置 必需参数：subscription_id（订阅ID）、resource_group（资源组）、cluster_name（集群名称）

5. 控制平面日志 - 查询AKS控制平面日志 支持的日志类别：

   • kube-apiserver
   • kube-audit
   • kube-audit-admin
   • kube-controller-manager
   • kube-scheduler
   • cluster-autoscaler
   • cloud-controller-manager
   • guard（用于身份验证/授权问题）
   • csi-azuredisk-controller
   • csi-azurefile-controller
   • csi-snapshot-controller
   • fleet-member-agent
   • fleet-member-net-controller-manager
   • fleet-mcs-controller-manager 注意：需要使用diagnostics工具检查集群诊断设置中是否启用了相应类别。

使用场景：

• 监控集群或其他Azure资源的性能和使用情况（使用metrics）
• 检查集群可用性和平台健康状况（使用resource_health）
• 分析应用遥测和性能（使用app_insights）
• 验证诊断日志配置（使用diagnostics）
• 调试Kubernetes API服务器问题（使用control_plane_logs和kube-apiserver）
• 调查身份验证/授权问题（使用control_plane_logs和kube-audit、guard）
• 排查Pod调度问题（使用control_plane_logs和kube-scheduler）
• 检查存储相关问题（使用control_plane_logs和csi-azuredisk-controller、csi-azurefile-controller）
• 分析集群扩展行为（使用control_plane_logs和cluster-autoscaler）
• 查看安全审计事件（使用control_plane_logs和kube-audit、kube-audit-admin）

示例：

metrics:

• 获取CPU使用率：operation="metrics", query_type="list", parameters="{"resource":"/subscriptions/sub-id/resourceGroups/rg/providers/Microsoft.ContainerService/managedClusters/cluster", "metrics":"node_cpu_usage_percentage", "aggregation":"Average", "start-time":"", "end-time":""}"
• 列出可用指标：operation="metrics", query_type="list-definitions", parameters="{"resource":"/subscriptions/sub-id/resourceGroups/rg/providers/Microsoft.ContainerService/managedClusters/cluster"}"

resource_health:

• 检查最近集群健康状况：operation="resource_health", subscription_id="", resource_group="", cluster_name="", parameters="{"start_time":""}"

app_insights:

• 查询请求遥测：operation="app_insights", subscription_id="", resource_group="", parameters="{"app_insights_name":"myapp-insights", "query":"requests | where timestamp > ago(1h) | summarize count() by bin(timestamp, 5m)"}"
• 分析异常：operation="app_insights", subscription_id="", resource_group="", parameters="{"app_insights_name":"myapp-insights", "query":"exceptions | where timestamp > ago(24h) | summarize count() by type, bin(timestamp, 1h)"}"
• 使用时间跨度的性能分析：operation="app_insights", subscription_id="", resource_group="", parameters="{"app_insights_name":"myapp-insights", "query":"performanceCounters | where category == 'Processor' | summarize avg(value) by bin(timestamp, 5m)", "timespan":"PT1H"}"

diagnostics:

• 验证诊断设置：operation="diagnostics", subscription_id="", resource_group="", cluster_name="", parameters="{}"

control_plane_logs:

• 查询API服务器日志：operation="control_plane_logs", subscription_id="", resource_group="", cluster_name="", parameters="{"log_category":"kube-apiserver", "start_time":"", "end_time":"", "max_records":"50"}"
• 调试身份验证问题：operation="control_plane_logs", subscription_id="", resource_group="", cluster_name="", parameters="{"log_category":"guard", "start_time":"", "end_time":"", "max_records":"100"}"
• 分析审计事件：operation="control_plane_logs", subscription_id="", resource_group="", cluster_name="", parameters="{"log_category":"kube-audit", "log_level":"error", "start_time":"", "end_time":"", "max_records":"50"}"

此工具可能执行破坏性更新。

*此工具与外部