rancher-cluster-management

Rancher 集群管理

导航和管理 Rancher 多集群环境。简单查询直接执行；复杂的多集群分析委托给 Sub-Agent。

直接操作（无需 Sub-Agent）

这些简单操作立即执行：

操作	工具	何时直接使用
列出集群	mcp__rancher__cluster_list	用户要求查看集群列表
按名称搜索集群	mcp__rancher__cluster_list	提供集群名称关键词
列出项目	mcp__rancher__project_list	用户要求查看项目列表
按集群列出项目	mcp__rancher__project_list	提供集群 ID

Sub-Agent 委托

rancher-cluster-explorer

用于: 集群概览、容量分析、多集群对比

何时委托:

• 用户要求"集群概览"或"集群健康状况"
• 用户要求对比多个集群
• 用户需要集群容量和资源使用信息

参数:

{
  "action": "cluster_overview" | "compare_clusters",
  "cluster": "c-abc123",
  "clusters": ["c-abc123", "c-def456"]
}

决策树

用户请求：
├─ "列出集群" / "list clusters" / "show all clusters"
│  └─ 直接使用 cluster_list
│
├─ "列出项目" / "list projects" + 集群名/ID
│  └─ 直接使用 project_list
│
├─ "集群概览" / "cluster overview" / "cluster health"
│  └─ 委托给 rancher-cluster-explorer（包含容量和节点分析）
│
├─ "对比集群 A 和 B" / "compare clusters"
│  └─ 委托给 rancher-cluster-explorer（并行分析多集群）
│
└─ "哪个集群有空间" / "which cluster has capacity"
   └─ 委托给 rancher-cluster-explorer（并行获取容量）

并行执行

多集群概览

用户: "对比 production 和 staging 集群"
→ 并行启动：
  Agent 1: rancher-cluster-explorer（集群 A 概览）
  Agent 2: rancher-cluster-explorer（集群 B 概览）
→ 合并对比展示

全集群扫描

用户: "所有集群的状态"
→ 步骤 1: 直接调用 cluster_list 获取所有集群
→ 步骤 2: 为每个集群并行启动 explorer Agent
→ 步骤 3: 汇总展示

工作流

步骤 1: 识别操作类型

• 简单列表？→ 直接调用 MCP 工具
• 需要概览/对比？→ 委托给 Sub-Agent

步骤 2: 获取集群 ID

如果用户提供集群名称而非 ID：

→ 使用 cluster_list（name: "关键词"）搜索
→ 获取匹配的集群 ID

步骤 3: 执行并展示结果

响应格式

集群列表

## 可用集群

| 集群 | ID | 状态 | 节点数 | Provider |
|------|-----|------|--------|----------|
| production | c-abc123 | Active | 5 | Custom |
| staging | c-def456 | Active | 3 | Custom |

集群概览

## 集群概览: production (c-abc123)

### 基本信息
- 状态: Active
- 节点数: 5
- 项目数: 3

### 资源容量
| 资源 | 请求 | 限制 | 实际使用 |
|------|------|------|----------|
| CPU | 65% | 120% | 45% |
| 内存 | 70% | 90% | 60% |

### 节点状态
| 节点 | 状态 | CPU | 内存 | Pod数 |
|------|------|-----|------|-------|
| node-1 | Ready | 55% | 62% | 42 |
| node-2 | Ready | 72% | 78% | 38 |

错误处理

• 集群未找到: 列出所有可用集群供用户选择
• 权限不足: 告知用户检查 Rancher token 权限
• 集群不可达: 显示集群状态，建议检查网络连接