S3 MCP Server
@samuraikun
About S3 MCP Server
MCP server to integrate AWS S3 and LLM
Basic information
Category
Files & Storage
License
MIT
Runtime
node
Transports
stdio
Publisher
samuraikun
Submitted by
Yuichi Kojima
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"aws-s3-mcp": {
"command": "npx",
"args": [
"aws-s3-mcp"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is S3 MCP Server?
An Amazon S3 Model Context Protocol (MCP) server that provides tools for LLMs like Claude to interact with S3 buckets and objects. It supports listing buckets, listing objects, and retrieving object contents.
How to use S3 MCP Server?
Install via npm (npm install -g aws-s3-mcp), configure AWS credentials and environment variables such as AWS_REGION, S3_BUCKETS, and S3_MAX_BUCKETS, then run with HTTP transport (default) or STDIO transport. For Claude Desktop, run the server with the --stdio flag and add it to the Claude Desktop configuration.
Key features of S3 MCP Server
- Supports STDIO, HTTP, and Streamable HTTP transports
- Tools: list-buckets, list-objects, get-object
- Deployment: local Node.js, Docker CLI, Docker Compose (with MinIO)
- Built-in MCP Inspector for debugging and testing
- Configurable allowed buckets and region
Use cases of S3 MCP Server
- Allow Claude or other LLMs to browse S3 buckets and retrieve objects
- Integrate S3 access directly into Claude Desktop workflows
- Test S3 interactions locally using MinIO with Docker Compose
- Debug MCP server behavior with the built-in inspector tool
FAQ from S3 MCP Server
What transports does the server support?
The server supports STDIO, HTTP, and Streamable HTTP transports. HTTP is the default transport; STDIO is required for Claude Desktop integration.
How do I configure AWS credentials?
Set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, and AWS_REGION, or rely on the default AWS credentials file. A .env file can also be used.
What are the prerequisites?
Node.js 18 or higher, npm, and AWS credentials. Docker is optional for containerized setups.
How can I test the server locally without real AWS credentials?
Use Docker Compose with MinIO: run ./run-inspector.sh --docker-compose to start a MinIO instance with sample buckets and objects.
What is the maximum number of buckets listed by default?
The server returns up to 5 buckets by default, configurable via the S3_MAX_BUCKETS environment variable.
More Files & Storage MCP servers
Google Drive MCP Server
hxie-pallasA google drive mcp servers based on Python
Google Drive server
isaacphiModel Context Protocol (MCP) Server for reading from Google Drive and editing Google Sheets
md-pdf-mcp (Markdown to PDF MCP Server)
seanivoreMarkdown To PDF Conversion MCP
PDF Extraction MCP Server (Claude Code Fork)
xraywuMCP server to extract contents from a PDF file
MCP docx server
h4ck4lifeMCP server to manipulate DOCX file
Comments