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