S3 MCP Server

@samuraikun

Repository

Basic information

About S3 MCP Server

MCP server to integrate AWS S3 and LLM

#aws #typescript #mcp #aws-s3 #mcp-servers #modelcontextprotocol

S3 MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "aws-s3-mcp": {
      "command": "npx",
      "args": [
        "aws-s3-mcp"
      ]
    }
  }
}

S3 MCP Server tools

List available S3 buckets

List objects in an S3 bucket

Retrieve an object from an S3 bucket

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

Frequently asked questions

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.

Comments

More Files & Storage MCP servers

mcp-v8: V8 JavaScript MCP Server

r33drichards

MCP server that exposes a V8 JavaScript runtime as a tool for AI agents like Claude and Cursor. Supports persistent heap snapshots via S3 or local filesystem, and is ready for integration with modern AI development environments.

pdfAssistant MCP Server

pdfassistant-ai

Official MCP server for pdfAssistant. Connect Claude, ChatGPT, or any MCP client to perform professional PDF processing like OCR, permanent redactions, secure encryption, format conversions, and 40+ advanced operations p