S3 Mcp

S3 Mcp

By ashgw GitHub

Fully Loaded AWS S3 Model Context Protocol Server (MCP)

s3-mcp aws-s3
Overview

What is S3 Mcp?

S3 Mcp is a fully loaded AWS S3 Model Context Protocol Server that allows users to manage S3 buckets and objects efficiently.

How to use S3 Mcp?

To use S3 Mcp, you can run it via Docker or integrate it with Cursor MCP configuration. Set your AWS credentials as environment variables and execute the server commands as specified in the documentation.

Key features of S3 Mcp?

  • Manage S3 buckets and objects
  • Handle lifecycle configurations
  • Set and retrieve object tags
  • Manage bucket policies
  • Configure CORS settings
  • Generate presigned URLs for object access

Use cases of S3 Mcp?

  1. Creating and managing S3 buckets for data storage.
  2. Uploading and retrieving files from S3 buckets.
  3. Setting up lifecycle rules for automatic data management.
  4. Configuring CORS for web applications accessing S3 resources.

FAQ from S3 Mcp?

  • Is S3 Mcp free to use?

Yes! S3 Mcp is open-source and free to use.

  • What are the prerequisites for using S3 Mcp?

You need to have Docker installed and valid AWS credentials to access S3 services.

  • Can I run S3 Mcp on my local machine?

Yes! You can run S3 Mcp locally using Docker.

Content

Overview

This server enables you to:

  • Manage S3 buckets and objects
  • Handle lifecycle configurations
  • Set and retrieve object tags
  • Manage bucket policies
  • Configure CORS settings

Installation

There are multiple ways to use this server depending on your setup.

Add this to your Cursor MCP configuration:

{
  "mcpServers": {
    "s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_SECRET_ACCESS_KEY=your_access_key",
        "-e",
        "AWS_ACCESS_KEY_ID=your_access_key",
        "-e",
        "AWS_REGION=your_region",
        "ashgw/s3-mcp:latest"
      ]
    }
  }
}

If you prefer pinning to a specific Docker image build (e.g., 20250413-165732), use that tag instead of latest. Browse available versions on Docker Hub.

Cursor will route that request through the MCP server automatically.

Make sure it's green and all the tools are available.

image

Docker (manual)

You can run the S3 MCP server manually via Docker:

docker run --rm -it \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=your_region \
  ashgw/s3-mcp

This uses the pre-built image published at ashgw/s3-mcp.

Repo

Clone the repository and cd into it, then build with:

docker build -t s3-mcp .

Then run with:

docker run --rm -e AWS_ACCESS_KEY_ID=your_access_key -e AWS_SECRET_ACCESS_KEY=your_secret_key -e AWS_REGION=your_region s3-mcp

Environment Variables

Set the following environment variables for AWS credentials:

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region

Features

  • List Buckets: Retrieve a list of all S3 buckets.
  • Create Bucket: Create a new S3 bucket with optional configurations.
  • List Objects: List all objects in a specified bucket.
  • Get Object: Retrieve the content of a specified object.
  • Put Object: Upload an object to a specified bucket.
  • Delete Object: Remove an object from a specified bucket.
  • Generate Presigned URL: Create a presigned URL for accessing or uploading an object.
  • Set Bucket Policy: Update or set a policy for a specified bucket.
  • Get Bucket Policy: Retrieve the current policy for a specified bucket.
  • Delete Bucket Policy: Remove the current policy for a specified bucket.
  • Lifecycle Configuration: Manage lifecycle rules for S3 buckets.
  • Object Tagging: Set and retrieve tags for S3 objects.
  • CORS Configuration: Get and set CORS rules for a bucket.
  • Copy Object: Copy an object from one location to another within S3.
  • Download File to Local: Download a file from a specified S3 bucket to a local path.
  • Upload Local File: Upload a local file to a specified S3 bucket.

Few Usage Examples

List Buckets

response = await tool("list_buckets")
print(response)

Create a Bucket

response = await tool("create_bucket", {
    "bucket_name": "my-new-bucket",
    "region": "us-west-1",
    "config": {
        "blockPublicAccess": {
            "BlockPublicAcls": True,
            "IgnorePublicAcls": True,
            "BlockPublicPolicy": True,
            "RestrictPublicBuckets": True
        },
        "versioning": True,
        "encryption": "AES256"
    }
})
print(response)

Upload a File

response = await tool("upload_local_file", {
    "bucket_name": "my-new-bucket",
    "local_path": "/path/to/local/file.txt",
    "key": "file.txt"
})
print(response)

Get Object Tags

response = await tool("get_object_tagging", {
    "bucket_name": "my-new-bucket",
    "key": "file.txt"
})
print(response)

License

MIT

No tools information available.
No content found.