Cloud Storage MCP 服务器

一个用于 Google Cloud Storage 的模型上下文协议 (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 中的路径替换为 index.js 的实际路径。

   在 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: 获取特定文件的详细信息
• uploadFile: 上传文件到 Cloud Storage 存储桶
• downloadFile: 从 Cloud Storage 存储桶下载文件
• deleteFile: 删除 Cloud Storage 存储桶中的文件

在 Claude Desktop 中的使用示例

以下是如何在 Claude Desktop 中使用每个工具的示例：

列出存储桶

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

获取存储桶中的文件

显示 backup-data 存储桶中的所有文件。

获取文件详细信息

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

开发

# 监听模式
npm run dev