The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Install
One-click install
Runs locallyClaude Code (no install link, copy and run)
$
claude mcp add aws-s3-mcp -- npx -y aws-s3-mcpButtons open the app on your computer and ask you to confirm before anything is added.
$
npx aws-s3-mcpmcp.json (Cursor, Claude Desktop, Windsurf)
{
"mcpServers": {
"aws-s3-mcp": {
"command": "npx",
"args": [
"-y",
"aws-s3-mcp"
]
}
}
}Install command taken from the project's README or registry entry. Always review code before running it.
README excerpt
Read full README on GitHub →S3 MCP Server
An Amazon S3 Model Context Protocol (MCP) server that provides tools for interacting with S3 buckets and objects.
https://github.com/user-attachments/assets/d05ff0f1-e2bf-43b9-8d0c-82605abfb666
Features
🚀 MCP Transport Support
- ✅ STDIO Transport - Direct process communication for Claude Desktop
- ✅ HTTP Transport - REST API with Server-Sent Events for web clients
- ✅ Streamable HTTP - Real-time streaming for responsive interactions
🛠️ Available Tools
- ✅ list-buckets - List accessible S3 buckets with filtering
- ✅ list-objects - Browse objects within buckets with prefix filtering
- ✅ get-object - Retrieve object contents (text/binary support)
🐳 Deployment Options
- ✅ Local Node.js - Direct execution with npm/node
- ✅ Docker CLI - Containerized deployment with custom configuration
- ✅ Docker Compose - Full stack with MinIO for local testing
- ✅ MCP Inspector - Built-in debugging and testing interface
Overview
This MCP server allows Large Language Models (LLMs) like Claude to interact with AWS S3 storage. It provides tools for:
- Listing available S3 buckets
- Listing objects within a bucket
- Retrieving object contents
The server is built using TypeScript and the MCP SDK, providing a secure and standardized way for LLMs to interface with S3.
Installation
Prerequisites
- Node.js 18 or higher
- npm or yarn
- AWS credentials configured (either through environment variables or AWS credentials file)
- Docker (optional, for containerized setup)
Setup
- Install via npm:
# Install globally via npm
npm install -g aws-s3-mcp
# Or as a dependency in your project
npm install aws-s3-mcp
- If building from source:
# Clone the repository
git clone https://github.com/samuraikun/aws-s3-mcp.git
cd aws-s3-mcp
# Install dependencies and build
npm install
npm run build
- Configure AWS credentials and S3 access:
Create a .env file with your AWS configuration:
AWS_REGION=us-east-1
S3_BUCKETS=bucket1,bucket2,bucket3
S3_MAX_BUCKETS=5
AWS_ACCESS_KEY_ID=your-access-key
AWS_SECRET_ACCESS_KEY=your-secret-key
Or set these as environment variables.
Configuration
The server can be configured using the following environment variables:
| Variable | Description | Default |
|---|---|---|
AWS_REGION |
AWS region where your S3 buckets are located | us-east-1 |
S3_BUCKETS |
Comma-separated list of allowed S3 bucket names | (empty) |
S3_MAX_BUCKETS |
Maximum number of buckets to return in listing | 5 |
AWS_ACCESS_KEY_ID |
AWS access key (if not using default credentials) | (from AWS config) |
AWS_SECRET_ACCESS_KEY |
AWS secret key (if not using default credentials) | (from AWS config) |
Running the Server
Direct Node.js Execution
The server runs with HTTP transport by default, making it easy to test and debug:
# Using npx (HTTP transport by default)
npx aws-s3-mcp
# If installed globally (HTTP transport)
npm install -g aws-s3-mcp
aws-s3-mcp
# If running from cloned repository (HTTP transport)
npm start
# Or directly (HTTP transport)
node dist/index.js
# Explicit HTTP transport
node dist/index.js --http
Similar plugs
Reverse engineer anything with agents, from app behavior down to native binaries.
Build Agentic workflows, RAG pipelines, with rich AI model and tool support on one collaborative workspace. Deploy on cloud, VPC, or self-hosted, so teams move from prototype…
A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Grok Build & Hermes Agent. Only official website: ccswitch.io
Open-source Python library for AI browser agents, plus Browser Use Cloud: stealth browsers and a hosted agent API.