S3 MCP Server

A Model Context Protocol server that interfaces with S3-compatible storage (like Cloudflare R2).

Features

• List buckets (s3_list_buckets)

• List objects in a bucket (s3_list_objects)

• Read object content (s3_read_object)

• Upload objects (s3_put_object)

• Delete objects (s3_delete_object)

Installation

1. Navigate to the directory:

   cd s3-mcp-server

2. Install dependencies:

   npm install

3. Build the server:

   npm run build

Configuration

To use this with an MCP client (like Claude Desktop or a custom client), add it to your configuration.

Cloudflare R2 Example

For Cloudflare R2, your endpoint should look like: https://<ACCOUNT_ID>.r2.cloudflarestorage.com

Running from GitHub (Recommended)

Running Locally

If you have cloned the repository and built it locally:

Environment Variables

• S3_ENDPOINT: The S3 API endpoint URL.

• S3_ACCESS_KEY_ID: Your access key ID.

• S3_SECRET_ACCESS_KEY: Your secret access key.

• S3_REGION: The region (default: "auto").

Tools

• s3_list_buckets: Lists all available buckets.

• s3_list_objects: Lists files in a bucket.

  • bucket: Name of the bucket.

  • prefix: (Optional) Filter by prefix.

• s3_read_object: Reads a file as text.

  • bucket: Name of the bucket.

  • key: File path/key.

• s3_put_object: Uploads text content to a file.

  • bucket: Name of the bucket.

  • key: File path/key.

  • content: Content string.

• s3_delete_object: Deletes a file.

  • bucket: Name of the bucket.

  • key: File path/key.