# @google-cloud/storage-mcp 中文文档

规范地址：https://npmcn.com/package/%40google-cloud/storage-mcp/

版本：0\.6\.0
npm 元数据更新时间：2026-05-06T23:39:44.313Z
中文译文更新时间：2026-11-16T20:00:50.117Z
软件包许可：Apache-2\.0

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40google-cloud/storage-mcp
原文对照：https://npmcn.com/package/%40google-cloud/storage-mcp/?lang=original
项目主页：https://github.com/googleapis/gcloud-mcp#readme
源码仓库：https://github.com/googleapis/gcloud-mcp

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：1.5 MB，4 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- 运行依赖：13 个
- 首次发布：2025-11-03T14:26:54.517Z
- 最新版本发布：2026-05-06T23:39:44.180Z
- 近 30 天下载量：197330（2026-10-17 至 2026-11-15，npm 官方下载统计）
- 已发布版本数：9（近 12 个月 7 个）

## 中文简介

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

## 安装

```sh
npm install @google-cloud/storage-mcp
```

也可以使用：`pnpm add @google-cloud/storage-mcp`、`yarn add @google-cloud/storage-mcp`、`bun add @google-cloud/storage-mcp`

## README

# 存储 MCP 服务器 QQ

存储器 [示范背景协议(MCP)](https://modelcontextprotocol.io/docs/getting-started/intro) 服务器使 AI 助手能够轻松地与 Google Cloud 存储器交互 桶和物品管理. 使用存储 MCP 服务器,您可以:

-   **与Google云存储使用自然语言的互动.** 说明 您想要的结果 而不是记忆复杂的命令语法、 旗帜和 参数.
    
    ![Natural Language Demo](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/natural_language.gif)
-   **自动化并简化复杂的工作流程.** 链式多存储操作 变成一个单一的、可重复的命令,以减少手动努力和机会 错误.
    
    ![Chained Commands Demo](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/chained.gif)
-   **为云存储管理降低出入口障碍.** 授权团队 较不熟悉GCS的成员自信地采取强有力的行动 安全无虞.
    
    ![Easy Access Demo](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/easy_access_3x.gif)
-   **在对象和桶上进行分析和汇总查询.** 执行 使用 [存储透视 数据集](https://cloud.google.com/storage/docs/insights/datasets)
    
    ![Easy Access Demo](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_insights_aggregation.gif)
-   **运行高级过滤器并搜索您的数据 .** 搜索和过滤对象 按文件类型、大小和其他元数据字段 [存储透视 数据集](https://cloud.google.com/storage/docs/insights/datasets)
    
    ![Easy Access Demo](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_insights_filter.gif)

## 开始

### 先决条件

-   [节点.js](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)数字 : 版本20或以上
-   [克卢德 CLI](https://cloud.google.com/sdk/docs/install) (用于认证)

## QQ 设置您的 MCP 服务器

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

将存储 MCP 服务器与双子座 CLI 或双子座代码辅助集成,运行 下面设置命令。 这将安装 MCP 服务器为 [双子体 CLI 扩展](https://github.com/google-gemini/gemini-cli/blob/main/docs/extension.md) 用于当前用户,并提供给您的所有项目.

```shell
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` 旗帜 :

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

### 其他AI客户端

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

```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( 人工设置 ):** [如果不使用扩展名](https://npmcn.com/package/%40google-cloud/storage-mcp/#readme-gemini-cli-and-gemini-code-assist)编辑 `.gemini/settings.json` 用于单一项目或 `~/.gemini/settings.json` 页:1 所有项目.

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

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

## 地方发展

关于在当地安装寄存器的更多信息,请参见: [发展.md](https://npmcn.com/package/%40google-cloud/storage-mcp/doc/DEVELOPMENT.md)

### 测试

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

```shell
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 作为服务账户](https://cloud.google.com/sdk/docs/authorizing#service-account) 并指定服务账户 a [带有有限权限的角色](https://cloud.google.com/iam/docs/roles-overview) 谷歌云存储.

## 捐款

我们欢迎捐款! 无论是修复错误,共享反馈,还是 欢迎你们的贡献。 请读我们的 [贡献指南](https://npmcn.com/package/%40google-cloud/storage-mcp/CONTRIBUTING.md) 要开始.

## 德摩斯语

**点击可观看存储 MCP 演示**  
[![Storage MCP Demo Video](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_mcp_demo_thumbnail.png)](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_mcp_demo.mp4 "Click to play demo")

**点击可观看存储透视驱动的存储 MCP 演示**  
[![Storage Insights MCP Demo Video](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_insights_demo_thumbnail.png)](https://npmcn.com/package/%40google-cloud/storage-mcp/assets/storage_insights_demo.mp4 "Click to play demo")

## 重要笔记

此寄存器正在预览中, 可能看到断开的更改 。 这个 寄存器提供了一个解决方案,而不是官方支持的Google产品. 当 MCP 规格、 其他 SDK 或 当其他溶液出现时可能断裂 和产品改变。 也见我们的 [安全政策](https://npmcn.com/package/%40google-cloud/storage-mcp/SECURITY.md)。 。 。 .

## 常见问题

### @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 和提交记录判断。

