What is Cloudstorage Mcp

cloudstorage-mcp is a Model Context Protocol (MCP) server designed to facilitate interactions with Google Cloud Storage, allowing users to manage buckets and files effectively.

Use cases

Use cases include managing file storage for web applications, backing up data to Google Cloud Storage, and automating file uploads and downloads in cloud-based workflows.

How to use

To use cloudstorage-mcp, install the required dependencies with ‘npm install’, build the project using ‘npm run build’, and configure the Claude Desktop by adding the necessary command and environment variables in the ‘claude_desktop_config.json’.

Key features

Key features include listing Cloud Storage buckets, retrieving details of specific buckets and files, uploading and downloading files, and deleting files from a bucket.

Where to use

cloudstorage-mcp can be used in various fields such as cloud computing, data storage management, and application development where interaction with Google Cloud Storage is required.

Cloud Storage MCP Server

A Model Context Protocol (MCP) server for Google Cloud Storage that enables interactions with Google Cloud Storage buckets and files.

Features

• List Cloud Storage buckets in a project
• Get details of a specific bucket
• List files in a bucket
• Get details of a specific file
• Upload files to a bucket
• Download files from a bucket
• Delete files from a bucket

Setup

1. Install dependencies:

   npm install
   

2. Build the project:

   npm run build
   

3. Configure Claude Desktop:
   Add the following to your claude_desktop_config.json:

   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.

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

   Ensure the relevant cloud service account has appropriate permission to interact with Cloud Storage, e.g. Storage Admin or lesser permission(s).

Available Tools

• listBuckets: List all Cloud Storage buckets in a project
• getBucket: Get details of a specific Cloud Storage bucket
• listFiles: List files in a Cloud Storage bucket
• getFile: Get details of 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

Example Usage in Claude Desktop

Here are examples of how to use each tool in Claude Desktop:

List Buckets

List all buckets in my Google Cloud project.

Get Files in a Bucket

Show me all files in the backup-data bucket.

Get File Details

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

Development

# Watch mode
npm run dev