用途:通过 kubectl-mcp-server 的 Cluster API 工具管理 Kubernetes 集群生命周期,适用于集群基础设施管理与多集群场景。触发关键词包括 Cluster API、CAPI、cluster lifecycle、machine、workload cluster,以及 provision cluster、scale workers、machine deployment、cluster class 等操作。
主要能力(共 11 个工具):capi_detect_tool 检测 CAPI 是否安装;capi_clusters_list_tool 列出集群及 Phase、基础设施与控制面就绪状态;capi_cluster_get_tool 查看集群 spec、status、网络配置;capi_cluster_kubeconfig_tool 获取工作负载集群 kubeconfig;capi_machines_list_tool 与 capi_machine_get_tool 查看机器状态、Provider ID、版本;capi_machinedeployments_list_tool 与 capi_machinedeployment_scale_tool 查看并扩缩 worker 节点;capi_machinesets_list_tool、capi_machinehealthchecks_list_tool、capi_clusterclasses_list_tool 分别查看 MachineSet、健康检查与可复用集群模板。
使用方式:优先规则为先用 capi_detect_tool 检测安装,再用 capi_cluster_get_tool 检查集群 Phase,扩缩时用 capi_machines_list_tool 监控机器,创建后用 capi_cluster_kubeconfig_tool 获取访问凭据。创建集群与 MachineDeployment 通过 kubectl_apply 提交清单,例如 capi_machinedeployment_scale_tool(name="my-cluster-md-0", namespace="default", replicas=5)。典型流程:创建集群后等待 Provisioned 再取 kubeconfig;扩缩先列出 MachineDeployment 再调整副本并监控;升级则更新控制面与 MachineDeployment 版本并监控 rollout。
限制与排障:资料未提供具体平台、收费或效果信息。集群卡在 Provisioning 时可检查集群 conditions、机器状态、事件及基础设施提供商日志;机器失败常见原因包括云配额、无效机器模板与网络问题。相关技能为 k8s-multicluster 与 k8s-operations。