Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

使用 MCP 将 LLM 连接到 Cloud Storage

本指南介绍了如何将 Cloud Storage 连接到集成开发环境 (IDE) 和开发者工具。为此，您可以使用 MCP Toolbox for Databases 在本地计算机上运行本地 MCP 服务器。

MCP Toolbox for Databases 是一个开源代码库，其中包含数据库和数据存储区的连接器，包括 Cloud Storage、BigQuery、AlloyDB、Spanner 和 Cloud SQL。该工具箱支持 OAuth2 和 OIDC 身份验证，并与 Open Telemetry 集成以实现可观测性。借助 Cloud Storage 工具箱集成，您可以使用 LLM 执行以下操作：

创建、列出和删除存储分区。
获取存储桶和对象元数据。
获取有关您的存储分区的 Identity and Access Management (IAM) 政策。
读取、写入、上传和下载对象。
复制或移动对象。

本指南演示了适用于以下 IDE 和工具的连接过程：

光标
Windsurf（以前称为 Codeium）
Visual Studio Code (Copilot)
Cline（VS Code 扩展程序）
Claude Desktop
Claude Code
Antigravity

准备工作

在 Google Cloud 控制台的项目选择器页面上，选择或创建 Google Cloud 项目。
确保您的 Google Cloud 项目已启用结算功能。
在 Google Cloud 项目中启用 Cloud Storage API。
配置完成此任务所需的角色和权限。调用 LLM 代理的用户需要在存储桶级或项目级层拥有以下角色：
- 列出存储分区、创建存储分区和删除空存储分区：Storage Admin (roles/storage.admin)
- 如需列出对象、读取对象、获取对象元数据或存储桶元数据，请使用 Storage Object Viewer (roles/storage.objectViewer)
- 如需将内容写入对象或上传对象，请使用 Storage Object Creator (roles/storage.objectCreator)
- 复制、移动或删除对象：Storage Object Admin (roles/storage.objectAdmin)
为您的环境配置应用默认凭证 (ADC)。

与 Antigravity 建立连接

您可以使用自定义配置将 Cloud Storage 连接到 Antigravity。在此背景下，自定义 MCP 服务器是指您通过修改配置文件（例如 mcp_config.json）手动配置的服务器。此手动配置用于代替直接从内置 MCP 商店目录安装服务器。

如需配置自定义 MCP 服务器，请执行以下操作：

在终端中运行 npx --version，验证 npx 是否已安装并正确配置在您的系统上。如果您需要安装 Node.js（其中包含 npx），请参阅 npm 下载并安装 Node.js 和 npm 指南。
打开 Antigravity，然后使用编辑器代理面板顶部的 “...” 下拉菜单前往 MCP 商店。
如需打开 mcp_config.json 文件，请依次点击 MCP 服务器和管理 MCP 服务器 > 查看原始配置。

添加以下配置，将占位符替换为您的项目 ID，然后保存：

{
  "mcpServers": {
    "storage": {
      "command": "npx",
      "args": ["-y","@toolbox-sdk/server","--prebuilt","cloud-storage","--stdio"],
      "env": {
          "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
      }
    }
  }
}

安装 MCP Toolbox

该工具箱是一个开源 Model Context Protocol (MCP) 服务器，可在您的计算机上本地运行。本地服务器管理 IDE 与 Cloud Storage 之间的通信。此连接可为您的 AI 工具提供安全高效的环境。

以二进制文件形式下载最新版本的 MCP Toolbox。选择与您的操作系统 (OS) 和 CPU 架构对应的二进制文件。您必须使用 MCP Toolbox 1.2.0 版或更高版本：
linux/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/linux/amd64/toolbox
将 VERSION 替换为 MCP Toolbox 版本，例如 v1.2.0。
macOS darwin/arm64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/arm64/toolbox
将 VERSION 替换为 MCP Toolbox 版本，例如 v1.2.0。
macOS darwin/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/darwin/amd64/toolbox
将 VERSION 替换为 MCP Toolbox 版本，例如 v1.2.0。
windows/amd64
curl -O https://storage.googleapis.com/mcp-toolbox-for-databases/VERSION/windows/amd64/toolbox
将 VERSION 替换为 MCP Toolbox 版本，例如 v1.2.0。
将该二进制文件设为可执行文件：
```
chmod +x toolbox
```
验证安装：
```
./toolbox --version
```

如需使用容器映像或 Homebrew 设置工具箱，请参阅安装工具箱页面。

设置客户端和连接

本部分介绍了在安装 MCP Toolbox 后如何将 Cloud Storage 连接到您的工具。

Claude Code

安装 Claude Code。
在项目根目录中创建 .mcp.json 文件（如果尚不存在）。

添加配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

重启 Claude Code 以加载新设置。当 Claude Code 重新打开时，应用会检测到配置的 MCP 服务器。

Claude Desktop

打开 Claude Desktop，然后前往设置。
在开发者标签页中，点击修改配置以打开配置文件。

添加配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

重启 Claude Desktop。
新聊天界面会显示锤子 (MCP) 图标以及新的 MCP 服务器。

Cline

在 VS Code 中打开 Cline 扩展程序，然后点击 MCP 服务器图标。
点击配置 MCP 服务器以打开配置文件。

添加以下配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

服务器成功连接后，系统会显示绿色的活跃状态。

光标

在项目根目录中创建 .cursor 目录（如果尚不存在）。
创建 .cursor/mcp.json 文件（如果尚不存在）并打开该文件。

添加以下配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

打开 Cursor，然后依次前往设置 > Cursor 设置 > MCP。服务器连接时，系统会显示绿色的活跃状态。

Visual Studio Code (Copilot)

打开 VS Code，并在项目根目录中创建 .vscode 目录（如果尚不存在）。
创建 .vscode/mcp.json 文件（如果尚不存在）并打开该文件。

添加以下配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

重新加载 VS Code 窗口。兼容 MCP 的扩展程序会自动检测配置并启动服务器。

Windsurf

打开 Windsurf 并前往 Cascade 助理。
点击 MCP 图标，然后点击配置以打开配置文件。

添加以下配置，将占位符替换为您的值，然后保存：

        {
          "mcpServers": {
            "storage": {
              "command": "./PATH/TO/toolbox",
              "args": ["--prebuilt","cloud-storage","--stdio"],
              "env": {
                "CLOUD_STORAGE_PROJECT": "PROJECT_ID"
              }
            }
          }
        }

将以下变量替换为您的值：

./PATH/TO/toolbox：toolbox 二进制文件的路径。
CLOUD_STORAGE_PROJECT：用于指定 Google Cloud 项目 ID 的环境变量。
PROJECT_ID：您的 Google Cloud 项目 ID。

预建工具

将 MCP Toolbox 连接到 Cloud Storage 后，智能体将使用以下预建工具：

list_buckets：列出已配置项目中的 Cloud Storage 存储分区。
list_objects：列出存储桶中的对象，并可选择性地使用前缀和定界符进行过滤。
get_bucket_metadata：返回存储桶的元数据。
get_bucket_iam_policy：返回存储桶的 IAM 政策绑定。
get_object_metadata：返回对象的元数据。
read_object：读取 UTF-8 文本对象（或字节范围）。上限为 8 MiB；二进制对象会被拒绝。
download_object：将对象下载到本地路径。
create_bucket：在配置的项目中创建存储桶。
delete_bucket：删除空存储桶。
upload_object：将本地文件上传到对象。
write_object：将文本内容直接写入对象。
copy_object：将对象复制到目标对象。
move_object：以原子方式重命名同一存储桶中的对象。
delete_object：删除对象。

使用 MCP 将 LLM 连接到 Cloud Storage 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

准备工作

与 Antigravity 建立连接

安装 MCP Toolbox

linux/amd64

macOS darwin/arm64

macOS darwin/amd64

windows/amd64

设置客户端和连接

Claude Code

Claude Desktop

Cline

光标

Visual Studio Code (Copilot)

Windsurf

预建工具

使用 MCP 将 LLM 连接到 Cloud Storage