Which integrations are available for this server?

Provides S3-compatible storage operations (list, get, put, delete, copy, presign) against Backblaze B2. Provides S3-compatible storage operations against Cloudflare R2, including reading, writing, and managing objects and buckets. Provides S3-compatible storage operations (list, get, put, delete, copy, presign, bucket management) against MinIO.

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@s3-mcp list all files in the 'reports' bucket" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

s3-mcp

A generic S3-protocol MCP server (stdio) that works against any S3-compatible endpoint — RustFS, MinIO, Cloudflare R2, Backblaze B2, AWS S3 — not just AWS.

Single Python package, one boto3 client created at startup, configuration via environment variables only. Built on the official mcp SDK (high-level server API) and boto3.

Configuration (environment variables)

Variable	Required	Default	Description
`S3_ENDPOINT_URL`	no	(unset)	S3-compatible endpoint; omit to target real AWS
`AWS_REGION`	no	`us-east-1`	Region for signing and bucket creation
`AWS_ACCESS_KEY_ID`	yes	—	Access key
`AWS_SECRET_ACCESS_KEY`	yes	—	Secret key
`S3_PATH_STYLE`	no	`true`	Path-style addressing (`https://host/bucket/key`) — required by most non-AWS stores
`S3_TLS_INSECURE`	no	`false`	`true` disables TLS certificate verification (self-signed endpoints)

Booleans accept true/false/1/0/yes/no (case-insensitive). Missing credentials or invalid booleans abort startup with a clear error.

Related MCP server: MinIO MCP Server

Tools

Tool	Read-only hint
`list_buckets()`	yes
`list_objects(bucket, prefix="", max_keys=1000)`	yes
`get_object(bucket, key)` → text if UTF-8 else `{base64, content_type}`	yes
`stat_object(bucket, key)`	yes
`presign_get(bucket, key, expires_s=3600)`	yes
`put_object(bucket, key, body, base64=false)`	no
`delete_object(bucket, key)`	no
`copy_object(src_bucket, src_key, dst_bucket, dst_key)`	no
`create_bucket(bucket)`	no
`delete_bucket(bucket)`	no
`presign_put(bucket, key, expires_s=3600)`	no

Tool errors are raised as short RuntimeError messages and surfaced by MCP as error results. Presigned URLs are capped at 7 days (604800 s), per SigV4.

Example configurations

RustFS with a self-signed certificate

{
  "mcpServers": {
    "s3-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "S3_ENDPOINT_URL=https://rustfs.local:9000",
        "-e", "S3_TLS_INSECURE=true",
        "-e", "AWS_REGION=us-east-1",
        "-e", "AWS_ACCESS_KEY_ID",
        "-e", "AWS_SECRET_ACCESS_KEY",
        "ghcr.io/jakeperalta7/s3-mcp:latest"
      ]
    }
  }
}

-e VAR without a value passes the variable through from your shell, so credentials never appear in the config file.

MinIO

{
  "mcpServers": {
    "s3-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "S3_ENDPOINT_URL=http://localhost:9000",
        "-e", "AWS_REGION=us-east-1",
        "-e", "AWS_ACCESS_KEY_ID",
        "-e", "AWS_SECRET_ACCESS_KEY",
        "ghcr.io/jakeperalta7/s3-mcp:latest"
      ]
    }
  }
}

AWS S3

Omit S3_ENDPOINT_URL; standard AWS credential/region resolution applies:

{
  "mcpServers": {
    "s3-mcp": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "AWS_REGION",
        "-e", "AWS_ACCESS_KEY_ID",
        "-e", "AWS_SECRET_ACCESS_KEY",
        "ghcr.io/jakeperalta7/s3-mcp:latest"
      ]
    }
  }
}

Without Docker (uv)

uvx --from git+https://github.com/JakePeralta7/s3-mcp s3-mcp

{
  "mcpServers": {
    "s3-mcp": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/JakePeralta7/s3-mcp", "s3-mcp"],
      "env": {
        "S3_ENDPOINT_URL": "http://localhost:9000",
        "AWS_ACCESS_KEY_ID": "...",
        "AWS_SECRET_ACCESS_KEY": "..."
      }
    }
  }
}

Development

uv sync --group dev   # install deps into .venv
uv run pytest -q      # unit tests (boto3 mocked, no network)
docker build -t s3-mcp:dev .

Entrypoint: python -m s3_mcp (stdio transport only).

Releasing

Every push to main runs tests, then publishes ghcr.io/<owner>/<repo>:<version> + :latest, where <version> is read from version in pyproject.toml. To release, bump the version and merge to main. Git tags are not used.

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

IronShard Object Storage Sandbox A
ai.ironshard
Create a free sandbox object storage bucket; upload, download, list, inspect, and delete objects.
Cloud Storage Developer Tools
81
OneDroid SynapseOAuth
ai.onedroid
Governed MCP gateway: one endpoint for your tools, with credential custody and audit log.
Security Observability
1
TitanStore Commerce MCP A
io.github.Fish-Tacos
MCP commerce surface for compute credits, API keys, GPU instances, and cloud storage.
Cloud Platforms E-commerce & Retail
52
Tigris MCP ServerOAuth
dev.storage
Tigris MCP Server seamlessly connects AI agents to Tigris bucket and object management.
Cloud Storage Cloud Platforms File Systems
2

Related MCP Servers

S3 MCP Server
Cloud Platforms Cloud Storage File Systems
rccyx
A
license
Not graded
quality
F
maintenance
Enables interaction with AWS S3 through MCP, supporting bucket and object management, lifecycle configurations, tagging, policies, CORS settings, presigned URLs, and file uploads/downloads.
Updated 10 months ago (2025-11-09 19:16 UTC)
3
MIT
MinIO MCP Server
Cloud Storage Cloud Platforms File Systems
Raphaelren
F
license
A
quality
D
maintenance
Provides tools for interacting with MinIO and S3-compatible object storage through MCP clients like Claude. It enables comprehensive bucket and object management, including listing, creating, uploading, and generating presigned URLs.
Updated 6 months ago (2026-03-09 05:39 UTC)
13
2
-
aws-s3-connector-mcp
Cloud Storage Cloud Platforms
sourav-spd
A
license
A
quality
C
maintenance
Enables MCP clients to connect to AWS S3 buckets, list, upload, and read objects in various formats, supporting public and private buckets with multiple transport modes.
Updated 2 months ago (2026-07-24 11:08 UTC)
4
MIT
bucket-helper-mcp
Cloud Storage Cloud Platforms
warith-harchaoui
A
license
Not graded
quality
A
maintenance
Provides MCP tools for AWS S3 and S3-compatible storage, enabling file upload, download, listing, deletion, and temporary remote file staging via natural language.
Updated 21 days ago (2026-08-24 20:41 UTC)
BSD 3-Clause