Cloudstorage MCP

🚀 Cloud Storage MCP Server

A Model Context Protocol (MCP) server for Google Cloud Storage, supporting interactive operations with Google Cloud Storage buckets and files.

🚀 Quick Start

This is a Model Context Protocol (MCP) server designed for Google Cloud Storage, enabling seamless interaction with Google Cloud Storage buckets and files.

✨ Features

• List cloud storage buckets in a project.
• Get detailed information about a specific bucket.
• List files in a bucket.
• Get detailed information about a specific file.
• Upload files to a bucket.
• Download files from a bucket.
• Delete files from a bucket.

📦 Installation

1. Install Dependencies

npm install

2. Build the Project

npm run build

3. Configure Claude Desktop

Add the following content to your claude_desktop_config.json file:

"cloudstorage-mcp": {
  "command": "node",
  "args": [
    "/path/to/cloudstorage-mcp/build/index.js"
  ],
  "env": {
    "GOOGLE_CLOUD_PROJECTS": "project-id1,project-id2"
  }
}

Replace the path in args with the actual path to index.js.

Define a comma-separated list of project IDs in GOOGLE_CLOUD_PROJECTS. Example: google-project-id1,google-project-id2 The first listed project is the default project.

The application expects to find a .json credential file for each project in the keys folder. Example: keys/google-project-id1.json

Ensure that the relevant cloud service account has appropriate permissions to interact with Cloud Storage, such as Storage Admin or less.

Available Tools

• listBuckets: List all cloud storage buckets in a project.
• getBucket: Get detailed information about a specific cloud storage bucket.
• listFiles: List files in a cloud storage bucket.
• getFile: Get detailed information about a specific file in a cloud storage bucket.
• uploadFile: Upload a file to a cloud storage bucket.
• downloadFile: Download a file from a cloud storage bucket.
• deleteFile: Delete a file from a cloud storage bucket.

💻 Usage Examples

Using in Claude Desktop

Here are examples of using each tool in Claude Desktop:

List Buckets

List all storage buckets in my Google Cloud project.

Get Files in a Bucket

Show all files in the backup-data storage bucket.

Get File Details

Get detailed information about the reports/monthly_report.pdf file in the data-analysis storage bucket.

Development

# Watch mode
npm run dev