Provides storage capabilities through a typed MCP contract.
mcp-storage
Universal cloud storage MCP server — manage files across AWS S3, Google Cloud Storage, Cloudflare R2, MinIO, and any S3-compatible provider through a single interface. 12 tools for listing, uploading, downloading,…
What it gives an agent
A purpose-built capability behind one MCP connection.
The server owns its domain logic and publishes a tool contract an MCP client can discover. ADK-Rust can load that contract into an agent, normalize each schema for the chosen model provider, and keep the connection lifecycle outside the agent’s business logic.
Architecture
How mcp-storage fits into an agent system.
The model never needs the implementation details or credentials of the system behind the server. It sees reviewed tool definitions. The MCP client handles discovery and calls, while the server keeps ownership of validation, policy, and communication with its domain system.
ADK-Rust agent
Chooses a capability from the reviewed tool catalog.
MCP client
Discovers schemas, sends calls, and receives typed content.
mcp-storage
Validates the request and owns 12 documented tool contracts.
Domain system
Keeps the API, data, credentials, and business rules behind the server.
This repository does not currently publish a dedicated architecture SVG. The integration diagram above is generated from its documented transport and server boundary; use the official README for implementation-specific details.
Tool catalog
What can an agent ask mcp-storage to do?
Each tool has a stable name, a human-readable purpose, and a JSON input contract discovered during MCP initialization. Risk classes come from the project’s registry manifest when one is available.
12 named tools
list_bucketsList all buckets/containers
read onlylist_objectsList objects in a bucket with optional prefix filter
read onlyget_object_infoGet object metadata
read onlydownload_objectDownload object content
read onlygenerate_presigned_urlGenerate temporary access URL
read onlyupload_objectUpload content to an object path
internal writecopy_objectCopy object within/between buckets
internal writemove_objectMove object (copy + delete source)
internal writedelete_objectDelete a single object
internal writecreate_bucketCreate a new bucket
internal writesearch_objectsSearch objects by prefix pattern
read onlyget_storage_usageGet storage usage summary for a bucket
read onlyGovernance
Understand the effect of every tool.
A server connection inherits the authority of its credentials and deployment environment. The declarations below come from this project’s README and MCP registry manifest; your application still decides which tools an agent receives and where approval is required.
- Write operations are gated — delete_object, move_object, and create_bucket require approval in governed environments
- Presigned URLs expire — default 1 hour, configurable per request
- No secrets in responses — credentials are never echoed back
- Read-only by default — browse and download tools don't modify anything
MCP surface
What the current documentation declares.
MCP can carry tools, resources, prompts, structured results, progress, cancellation, and long-running work. This record highlights the modern protocol features explicitly mentioned by this repository.
Install and connect
Follow the project’s documented starting point.
Install the server in the environment that owns its credentials and domain access. Add it to your MCP host, verify the discovered tools, and narrow the toolset before giving it to a production agent.
cargo install mcp-storage{
"mcpServers": {
"storage": {
"command": "mcp-storage",
"env": {
"STORAGE_ENDPOINT": "https://storage.googleapis.com",
"STORAGE_ACCESS_KEY": "GOOG1E...",
"STORAGE_SECRET_KEY": "your-secret",
"STORAGE_REGION": "us-east-1"
}
}
}
}Commands and configuration are extracted from the public README. Confirm prerequisites, environment variables, and release-specific options in the official documentation before deployment.
Official documentation
Continue with the project maintainers’ source of truth.
This page provides an approachable map of the server. The repository remains authoritative for exact schemas, prerequisites, configuration, examples, tests, releases, and security updates.
Keep exploring
More in data & content.
Source record
Release and repository metadata for this catalog entry.
- Version
- 1.0.1
- License
- Apache-2.0
- Tools
- 12
- Revision
- d8f02e610c50
- Updated
- May 27, 2026