Cloudstorage MCP

🚀 云存储 MCP 服务器

云存储 MCP 服务器是一个专为 Google Cloud Storage 打造的 Model Context Protocol (MCP) 服务器，它能让你轻松与 Google Cloud Storage 的桶和文件进行交互操作。

🚀 快速开始

云存储 MCP 服务器可帮助你便捷地与 Google 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：列出项目中的所有云存储桶
• getBucket：获取特定云存储桶的详细信息
• listFiles：列出云存储桶中的文件
• getFile：获取云存储桶中特定文件的详细信息
• uploadFile：上传文件到云存储桶
• downloadFile：下载云存储桶中的文件
• deleteFile：删除云存储桶中的文件

💻 使用示例

基础用法

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

列出桶

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

获取桶中的文件

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

获取文件的详细信息

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

开发

# 监视模式
npm run dev