Cloud Storage MCP 服务器

这是一个用于 Google Cloud Storage 的 Model Context Protocol (MCP) 服务器，它能够与 Google Cloud Storage 存储桶和文件进行交互。

功能

• 列出项目中的 Cloud Storage 存储桶
• 获取特定存储桶的详细信息
• 列出存储桶中的文件
• 获取特定文件的详细信息
• 将文件上传到存储桶
• 从存储桶下载文件
• 从存储桶删除文件

配置

1. 安装依赖项：

   npm install
   

2. 构建项目：

   npm run build
   

3. 配置 Claude Desktop： 在你的 claude_desktop_config.json 中添加以下内容：

   "cloudstorage-mcp": {
     "command": "node",
     "args": [
       "/path/to/cloudstorage-mcp/build/index.js"
     ],
     "env": {
       "GOOGLE_CLOUD_PROJECTS": "project-id1,project-id2"
     }
   }
   

   使用实际路径替换 args 中的路径。

   在 GOOGLE_CLOUD_PROJECTS 中定义一个逗号分隔的项目 ID 列表。 示例：google-project-id1,google-project-id2 第一个列出的项目是默认项目。

   应用程序期望在每个项目的 keys 文件夹中找到 .json 凭证文件。 示例：keys/google-project-id1.json

   确保相关的云服务账户具有与 Cloud Storage 交互的适当权限，例如 Storage Admin 或更低级别的权限。

可用工具

• listBuckets：列出项目中的所有 Cloud Storage 存储桶
• getBucket：获取特定 Cloud Storage 存储桶的详细信息
• listFiles：列出 Cloud Storage 存储桶中的文件
• getFile：获取 Cloud Storage 存储桶中特定文件的详细信息
• uploadFile：将文件上传到 Cloud Storage 存储桶
• downloadFile：从 Cloud Storage 存储桶下载文件
• deleteFile：从 Cloud Storage 存储桶删除文件

在 Claude Desktop 中的示例使用

这里有一些如何在 Claude Desktop 中使用每种工具的例子：

列出存储桶

列出我 Google Cloud 项目中的所有存储桶。

显示存储桶中的文件

显示备份数据存储桶中的所有文件。

获取文件详细信息

获取 data-analysis 存储桶中 reports/monthly_report.pdf 文件的详细信息。

开发

# 监控模式
npm run dev