S3 MCP

🚀 S3 MCP Server

This server enables you to manage S3 buckets and objects, handle lifecycle configurations, set and retrieve object tags, manage bucket policies, and configure CORS settings.

🚀 Quick Start

This server allows you to perform the following operations:

• 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.

Using Cursor (Recommended)

Add the following 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"
      ]
    }
  }
}

⚠️ Important Note

If you wish to pin to a specific Docker image build (e.g., 20250413-165732), use that tag instead of latest. Check the available versions on Docker Hub .

Cursor will automatically route requests to the MCP server. Ensure all tools are running and have a green status.

Docker (Manual)

You can manually run the S3 MCP server 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 command uses a pre-built image published at ashgw/s3-mcp .

Source Code Repository

Clone the repository and cd into it, then build using the following command:

docker build -t s3-mcp .

Then run:

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 to configure 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: Get a list of all S3 buckets.
• Create Bucket: Create a new S3 bucket with optional configuration.
• List Objects: List all objects in a specified bucket.
• Get Object: Retrieve the content of a specified object.
• Upload Object: Upload an object to a specified bucket.
• Delete Object: Delete an object from a specified bucket.
• Generate Presigned URL: Create a presigned URL to access or upload an object.
• Set Bucket Policy: Update or set the policy for a specified bucket.
• Get Bucket Policy: Retrieve the current policy of a specified bucket.
• Delete Bucket Policy: Remove the current policy of a specified bucket.
• Lifecycle Configuration: Manage the lifecycle rules of an S3 bucket.
• Object Tagging: Set and retrieve tags for S3 objects.
• CORS Configuration: Get and set the CORS rules for a bucket.
• Configuration Example: See how to use this server in a real - world scenario.

💻 Usage Examples

Basic Usage

# Example Python code
def list_buckets():
    # Connect to the S3 service
    s3 = boto3.client('s3')
    # Get all buckets
    buckets = s3.list_buckets()
    # Print bucket names
    for bucket in buckets['Buckets']:
        print(bucket['Name'])

list_buckets()

Advanced Usage

# Example Python code
def create_bucket():
    # Create an S3 client
    s3 = boto3.client('s3')
    # Define bucket configuration
    bucket_config = {
        'LocationConstraint': 'us-west-2'
    }
    # Create the bucket
    response = s3.create_bucket(
        Bucket='my-new-bucket',
        CreateBucketConfiguration=bucket_config
    )
    # Print the creation result
    print(response)

create_bucket()

📄 License

This project is licensed under the MIT License .