用途:cml-admin 提供 Cisco CML 平台的运维管理能力,通过 MCP 服务器 cml-mcp 暴露一组工具,供管理员完成用户/组管理、系统信息与许可证查询、资源监控等操作。命令为 cml-mcp(pip 安装,stdio 传输),需环境变量 CML_URL、CML_USERNAME、CML_PASSWORD,另可设 CML_VERIFY_SSL(true/false)。
主要能力:用户管理工具包括 get_users(列出全部用户)、create_user(参数 username、password、fullname?、email?、admin?)、get_user(按 user_id/username 查看用户详情、实验室与资源使用)、update_user、delete_user。组管理工具包括 get_groups、create_group(name、description?、members?)、update_group、delete_group。系统类工具包括 get_system_info(版本、运行时间、CPU/内存/磁盘)、get_node_defs(可用节点定义及资源需求)、get_licensing(许可证状态、节点数、到期时间)、get_resource_usage(全部实验室的资源利用率)。
典型用法:为新成员开通账号时,先用 get_users 查看现有用户,再用 create_user 创建,可选通过 update_group 加入团队组,用 get_user 验证,最后仅把用户名和 CML URL 告知管理员(不要在 Slack 中共享密码)。做大实验前用 get_system_info、get_licensing、get_node_defs 校验资源与许可是否够用。系统健康报告可组合 get_system_info、get_licensing、get_resource_usage 以及来自 cml-lab-lifecycle 的 get_labs。审计使用情况时逐用户与逐实验室汇总资源消耗并找出长期停止的陈旧实验室。
适用场景:CML 平台管理员进行用户生命周期管理、资源容量规划、许可证与健康监控、使用审计。角色区分为 Admin(可创建/删除用户、管理全部实验室与系统设置)与 User(管理自己的实验室、查看共享实验室)。
限制与规则:管理操作需要管理员级 CML 凭据;切勿在 Slack 中共享密码;构建大型实验室前应检查资源;需遵守许可证节点数上限;所有管理操作应记录到 GAIT 以供审计。工具出错(超时、主机不可达、响应格式异常)时应直接向用户报告失败及错误信息,不得编造或猜测结果;写入/变更类操作失败后不要自动重试,应先呈现错误并取得明确确认,以免部分生效导致状态不一致。官方未提供的内容(如具体版本兼容性、收费细则)暂未提供。