Cloud Storage MCP Server

What is Cloud Storage MCP Server?

A Model Context Protocol (MCP) server for Google Cloud Storage that enables interactions with Google Cloud Storage buckets and files. It is intended for developers using Claude Desktop or other MCP-compatible clients to manage GCS resources via natural language commands.

How to use Cloud Storage MCP Server?

Install dependencies with npm install, build with npm run build, then configure Claude Desktop by adding a JSON entry to claude_desktop_config.json that points to the built index.js and sets the GOOGLE_CLOUD_PROJECTS environment variable. Place a corresponding .json credential file for each project in the keys folder.

Key features of Cloud Storage MCP Server

• 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

Use cases of Cloud Storage MCP Server

• View all buckets in a Google Cloud project from Claude Desktop
• Retrieve file metadata and contents from a backup bucket
• Upload reports or data files to a storage bucket without leaving your chat interface
• Delete outdated files from a bucket to manage storage costs
• Explore bucket and file structure interactively for debugging or auditing

FAQ from Cloud Storage MCP Server

What is this server for?

It is an MCP server that provides tools to perform CRUD operations on Google Cloud Storage buckets and files through an MCP client such as Claude Desktop.

What are the prerequisites to use the server?

You need Node.js, npm, at least one Google Cloud project, and a service account with appropriate Cloud Storage permissions (e.g., Storage Admin). Credential files in JSON format must be placed in the keys folder.

How do I configure the server?

Set the GOOGLE_CLOUD_PROJECTS environment variable to a comma-separated list of project IDs (the first is the default). The server expects a credential file named <project-id>.json inside the keys directory for each project.

What tools does the server provide?

The server exposes seven tools: listBuckets, getBucket, listFiles, getFile, uploadFile, downloadFile, and deleteFile.

Where are credentials stored?

Credentials are stored locally in the keys folder as JSON files named after the Google Cloud project ID (e.g., keys/my-project-id.json). Ensure the service account has the necessary IAM permissions on the targeted Cloud Storage resources.