用途:在 Google Cloud Storage(GCS)存储桶中以对象形式存储、读取和管理数据,适合网站内容、备份、数据湖及 AI/ML 训练等场景。GCS 以不可变对象存储,具备强全局一致性,提供多种存储类别和位置类型,并集成 IAM 做细粒度访问控制。
主要能力:优先使用 cloud-storage MCP 工具(本地 MCP Toolbox 14 个工具或 Google 托管远程服务器 8 个工具),覆盖列出/创建/删除桶、列出/读取/上传/下载/复制/移动/删除对象等。read_object 上限 8 MiB,本地仅读 UTF-8 文本,远程还支持 PDF 和图片;二进制或更大对象用 download_object 或 upload_object。MCP 不可用时回退到 gcloud storage 或 JSON API,可处理生命周期规则、软删除、UBLA、PAP、CMEK、保留策略、CORS、rsync、签名 URL、HMAC、Pub/Sub 通知、HNS 文件夹、IAM 更新、递归删除等 MCP 未覆盖功能。
使用方式:启用 API 用 gcloud services enable storage.googleapis.com --quiet;创建桶用 gcloud storage buckets create gs://my-bucket --location=us-central1;上传用 gcloud storage cp ./my-file.txt gs://my-bucket;下载用 gcloud storage cp gs://my-bucket/my-file.txt .。执行 gcloud 命令需加指标环境变量前缀,HTTP 调用需设置 User-Agent: gcs-skills/1.0 (skill:google-cloud-storage-basics)。删除桶/对象、移动或覆盖内容前必须获得用户明确确认。生产或特定工作负载的桶应路由到 google-cloud-storage-bucket-architect。
限制:桶名全局唯一,省略位置默认美国多区域;gcloud 输出键为 snake_case;未安装匹配技能时用 npx skills add GoogleCloudPlatform/google-cloud-storage-plugin --skill <skill-name> 安装,不要自行发挥。