用途:为 AI 智能体调用 gcloud CLI 提供安全关键的语法校验、防护规则与数据裁剪,降低幻觉命令和破坏性操作风险,并节省上下文窗口。
主要能力与规则:所有 gcloud 命令、标志、参数在使用前必须通过 gcloud help <叶子命令> 验证,父级命令帮助不足以校验,禁止用网络搜索获取语法。生成计划时必须按固定四步:语法验证、参数确认(检查是否支持 --dry-run 或 --validate-only)、先执行 dry-run、再提出或执行命令。列表命令必须带 --limit、--filter 或 --format 之一;可用 gcloud <GROUP> <RESOURCE> list --limit=1 --format=json 先探测字段结构;相关主题帮助为 gcloud topic filters、gcloud topic formats、gcloud topic projections。
使用方式:支持在本地或自动化 shell 中直接执行 gcloud,也可通过 Cloud CLI 远程 MCP 服务器的 run_gcloud_command 调用。命令须逐条执行,禁止管道、重定向和命令替换;所有执行命令加 --quiet 保证非交互;显式指定 --project=<PROJECT_ID> 与区域/可用区等位置标志;位置不明时先运行 gcloud compute regions list 或 gcloud <GROUP> locations list。
限制:删除、更新、移除等破坏性操作需人工授权;IAM 策略与角色修改、账单、组织级、KMS、infra-manager deployments apply 等禁止自主执行;不主动启用 API;支持时优先使用 --dry-run 或 --validate-only,长时间操作可用 --async 并用 gcloud operations describe 查询状态。