s3-mcp

s3-mcp

0
cloud_storage

This project provides a server tool to manage AWS S3 buckets and objects. It includes functionalities such as object lifecycle configuration, policy management, and CORS settings. Users can perform tasks like listing, creating, and deleting buckets and objects efficiently.

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.

Cursor (recommended)

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