@google-cloud/storage-mcp

中文文档
0.6.0发布于 2026/05/07Apache-2.0ES Module近 30 天下载 19.7万

用于与 GCS API 互动的 模型上下文协议服务器

中文使用文档
文档目录14 节
  1. 开始
  2. 先决条件
  3. QQ 设置您的 MCP 服务器
  4. 双子星CLI和双子星代码辅助
  5. 其他AI客户端
  6. 地方发展
  7. 测试
  8. 可用的 MCP 工具
  9. 安全工具
  10. 破坏性工具
  11. QQ MCP 权限
  12. 捐款
  13. 德摩斯语
  14. 重要笔记

存储 MCP 服务器 QQ

存储器 示范背景协议(MCP) 服务器使 AI 助手能够轻松地与 Google Cloud 存储器交互 桶和物品管理. 使用存储 MCP 服务器,您可以:

  • 与Google云存储使用自然语言的互动. 说明 您想要的结果 而不是记忆复杂的命令语法、 旗帜和 参数.

    Natural Language Demo
  • 自动化并简化复杂的工作流程. 链式多存储操作 变成一个单一的、可重复的命令,以减少手动努力和机会 错误.

    Chained Commands Demo
  • 为云存储管理降低出入口障碍. 授权团队 较不熟悉GCS的成员自信地采取强有力的行动 安全无虞.

    Easy Access Demo
  • 在对象和桶上进行分析和汇总查询. 执行 使用 存储透视 数据集

    Easy Access Demo
  • 运行高级过滤器并搜索您的数据 . 搜索和过滤对象 按文件类型、大小和其他元数据字段 存储透视 数据集

    Easy Access Demo

开始

先决条件

QQ 设置您的 MCP 服务器

双子星CLI和双子星代码辅助

将存储 MCP 服务器与双子座 CLI 或双子座代码辅助集成,运行 下面设置命令。 这将安装 MCP 服务器为 双子体 CLI 扩展 用于当前用户,并提供给您的所有项目.

npx @google-cloud/storage-mcp init --agent=gemini-cli

初始化过程后,您可以验证存储-mcp服务器是 通过运行以下命令正确配置 :

gemini mcp list

> ✓ gcs: npx -y @google-cloud/storage-mcp (stdio) - Connected

默认情况下,服务器只允许安全,无损的工具. 启用 可修改或删除现有数据的工具 --enable-destructive-tools 旗帜 :

npx @google-cloud/storage-mcp init --agent=gemini-cli --enable-destructive-tools

其他AI客户端

要与其他客户端一起使用存储 MCP 服务器, 请在他们的客户端中添加以下片段 各自的 JSON 配置文件 :

"gcs": {
  "command": "npx",
  "args": ["-y", "@google-cloud/storage-mcp"]
}

流行工具说明 :

  • 克劳德桌面 : 打开 克劳德 > 设置 > 开发者 > 编辑配置 财务报告和审定财务报表 编辑 claude_desktop_config.json。 。 。 .
  • 线条 : 然后单击 MCP 服务器图标 配置 MCP 服务器 要编辑 cline_mcp_settings.json。 。 。 .
  • 光标 : 编辑 .cursor/mcp.json 用于单一项目或 ~/.cursor/mcp.json 所有项目.
  • 双子座 CLI( 人工设置 ): 如果不使用扩展名编辑 .gemini/settings.json 用于单一项目或 ~/.gemini/settings.json 页:1 所有项目.

对于 视觉工作室代码 编辑 .vscode/mcp.json 在工作空间中的文件 用于单个工程或您所有工程的全局用户设置文件:

"servers": {
  "gcs": {
    "command": "npx",
    "args": ["-y", "@google-cloud/storage-mcp"]
  }
}

地方发展

关于在当地安装寄存器的更多信息,请参见: 发展.md

测试

要运行集成或E2E测试,您需要设置 GOOGLE_CLOUD_PROJECT 或者说 GCP_PROJECT_ID 环境变量为有效 谷歌云项目ID.

export GOOGLE_CLOUD_PROJECT=your-gcp-project-id
npm run test:integration --workspace=packages/storage-mcp
npm run test:e2e --workspace=packages/storage-mcp

可用的 MCP 工具

存储 MCP 服务器提供两套工具: 安全工具 财务报告和审定财务报表 破坏性工具。默认情况下,只启用安全工具来防止 意外数据损失.

安全工具

安全工具只读或只创建新对象而不影响现有 这些。 它们永远不会修改或删除GCS中的现有数据.

工具说明
list_buckets列出项目中的所有桶 .
get_bucket_metadata获取特定桶的综合元数据 .
get_bucket_location得到一个桶的位置.
view_iam_policy查看IAM的一桶政策.
check_iam_permissions测试IAM对一桶的许可.
create_bucket创建新桶 。 如果桶已经存在, 则失败 .
list_objects在 GCS 桶中列出对象.
read_object_metadata读取特定对象的综合元数据.
read_object_content读取特定对象的内容.
write_object_new写入新对象。 如果对象已经存在, 则失败 .
upload_object_new上传文件到新对象。 如果对象已经存在, 则失败 .
copy_object_new复制对象到新目的地。 如果目的地已经存在, 则失败 .
get_metadata_table_schema检查是否启用了 GCS 透视服务, 并返回给定的透视数据集配置的 BigQuery 表策略 .
execute_insights_query执行针对透视数据集的大查询 SQL 查询并返回结果.
list_insights_configs列出特定工程的所有存储透视数据集配置的名称.

破坏性工具

警告: 这些工具可以永久地修改或删除已存在的数据. 启用 只有在你确信特工应该被允许表演时 这些行动.

你可以通过运行 init 命令与 --enable-destructive-tools 旗帜。 启用后,这些工具将取代其保险箱 (例如, write_object 已注册,而不是 write_object_new) (中文(简体) ).

工具说明
delete_bucket删除 一个桶.
update_bucket_labels修改 桶的标签.
delete_object删除 从桶中取出特定物体.
update_object_metadata修改 已存在的对象的自定义元数据.
download_object下载对象, 覆盖 目标文件.
move_object移动 对象(复制后删除正本).
write_object写入对象, 覆盖 如果它已经存在.
upload_object上传文件, 覆盖 目标对象.
copy_object复制对象, 覆盖 目标对象.

QQ MCP 权限

存储 MCP 的权限直接与权限相连 经认证的用户或服务账户。 限制权限和操作 最低特权原则,你可以 授权 gcloud 作为服务账户 并指定服务账户 a 带有有限权限的角色 谷歌云存储.

捐款

我们欢迎捐款! 无论是修复错误,共享反馈,还是 欢迎你们的贡献。 请读我们的 贡献指南 要开始.

德摩斯语

点击可观看存储 MCP 演示
Storage MCP Demo Video

点击可观看存储透视驱动的存储 MCP 演示
Storage Insights MCP Demo Video

重要笔记

此寄存器正在预览中, 可能看到断开的更改 。 这个 寄存器提供了一个解决方案,而不是官方支持的Google产品. 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 安全政策。 。 。 .

版本与发布记录

@google-cloud/storage-mcp 共发布 9 个版本,首次发布于 2025/11/03;过去 12 个月发布了 7 个版本。

版本发布日期距今
0.6.0latest2026/05/076 个月前
0.5.12026/04/286 个月前
0.5.02026/04/117 个月前
0.4.02026/04/107 个月前
0.3.32026/02/119 个月前
0.3.22026/01/0610 个月前

关于 @google-cloud/storage-mcp 的常见问题

@google-cloud/storage-mcp 是什么?

用于与 GCS API 互动的 模型上下文协议服务器

如何安装 @google-cloud/storage-mcp?

在项目目录运行 npm install @google-cloud/storage-mcp,或使用 pnpm add / yarn add / bun add。它还提供命令行工具 storage-mcp,可以用 npx storage-mcp 直接运行。

@google-cloud/storage-mcp 支持 TypeScript 吗?

该包的 package.json 没有声明类型入口。需要类型提示时,可以在 npm 上查找社区维护的 @types/google-cloud__storage-mcp 是否存在。

@google-cloud/storage-mcp 支持 ESM 还是 CommonJS?

以 ES Module 形式发布,推荐使用 import 引入。在 CommonJS 项目中,Node.js 20.19+ / 22.12+ 可以直接 require() 不含顶层 await 的 ES Module,更早的版本需要改用动态 import()。

@google-cloud/storage-mcp 可以商用吗?

@google-cloud/storage-mcp 使用 Apache-2.0 许可。宽松许可:允许商业使用、修改和再分发,并附带明确的专利授权;分发时需保留许可与 NOTICE 文件,修改过的文件要注明改动。以上为概括,不构成法律意见,请以许可原文为准。

@google-cloud/storage-mcp 的下载量有多少?

根据 npm 官方下载统计,@google-cloud/storage-mcp 在 2026/10/17 – 2026/11/15 这 30 天内被下载 197,330 次,日均约 6,578 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入,适合横向比较热度,不能直接等同于使用人数。

@google-cloud/storage-mcp 还在维护吗?

最新版本 0.6.0 发布于 2026/05/07(6 个月前);至今共发布 9 个版本,其中过去 12 个月发布了 7 个;首次发布于 2025/11/03。发布频率只是参考信号:功能稳定的工具可能很少需要更新,建议结合源码仓库的 issue 和提交记录判断。