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
- Navigate to the directory:
cd s3-mcp-server - Install dependencies:
npm install - 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)
{
"mcpServers": {
"s3": {
"command": "npx",
"args": [
"-y",
"github:AM1010101/s3-mcp-server"
],
"env": {
"S3_ENDPOINT": "https://<YOUR_ACCOUNT_ID>.r2.cloudflarestorage.com",
"S3_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
"S3_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
"S3_REGION": "auto"
}
}
}
}
Running Locally
If you have cloned the repository and built it locally:
{
"mcpServers": {
"s3": {
"command": "node",
"args": ["/absolute/path/to/s3-mcp-server/dist/index.js"],
"env": {
"S3_ENDPOINT": "https://<YOUR_ACCOUNT_ID>.r2.cloudflarestorage.com",
"S3_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY_ID>",
"S3_SECRET_ACCESS_KEY": "<YOUR_SECRET_ACCESS_KEY>",
"S3_REGION": "auto"
}
}
}
}
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.