Cloudstorage 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