Cloud Storage MCP Server

Cloud Storage MCP サーバー

Google Cloud Storage のバケットやファイルを操作できる、Google Cloud Storage 用の Model Context Protocol（MCP）サーバーです。

機能

• プロジェクト内の 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：Cloud Storage バケット内の特定のファイルの詳細を取得する
• uploadFile：Cloud Storage バケットにファイルをアップロードする
• downloadFile：Cloud Storage バケットからファイルをダウンロードする
• deleteFile：Cloud Storage バケットからファイルを削除する

Claude Desktop での使用例

Claude Desktop で各ツールを使用する例を紹介します。

バケットの一覧表示

List all buckets in my Google Cloud project.

バケット内のファイルの取得

Show me all files in the backup-data bucket.

ファイルの詳細の取得

Get details of the file reports/monthly_report.pdf in the data-analysis bucket.

開発

# Watch mode
npm run dev