cloudstorage-mcp

🚀 云存储 MCP 服务器

云存储 MCP 服务器是一个专为 Google Cloud Storage 设计的 Model Context Protocol (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 中使用示例

基础用法

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

列出桶

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

获取桶中的文件

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

获取文件的详细信息

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

开发

# 监视模式
npm run dev