S3 MCP Server

@Geun-Oh

About S3 MCP Server

⚙️ A Model Context Protocol (MCP) server for accessing Amazon S3 buckets. This server provides seamless integration with S3 storage through MCP, allowing efficient handling of large files including PDFs through streaming capabilities.

Config

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

{
  "mcpServers": {
    "s3-mcp-server-geun-oh": {
      "command": "npx",
      "args": [
        "-y",
        "@geunoh/s3-mcp-server"
      ]
    }
  }
}

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?

A Model Context Protocol (MCP) server for accessing Amazon S3 buckets. It provides seamless integration with S3 storage through MCP, allowing efficient handling of large files including PDFs via streaming.

How to use S3 MCP Server?

Install with npx -y @geunoh/s3-mcp-server. Configure via CLI options (port, region, bucket) or environment variables (AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, optionally AWS_REGION, S3_BUCKET_NAME). Add to mcp.json and invoke with the npx command. Use the listObjects and getObject MCP functions.

Key features of S3 MCP Server

S3 bucket object listing with prefix filtering
Efficient large file handling through streaming
Secure AWS credentials management
TypeScript support
CLI interface with customizable options

Use cases of S3 MCP Server

List objects in an S3 bucket with a prefix filter
Retrieve large files (including PDFs) via streaming
Integrate S3 storage into MCP-powered AI applications

FAQ from S3 MCP Server

How do I install S3 MCP Server?

Install via npx -y @geunoh/s3-mcp-server. No additional dependencies are required.

What environment variables are required?

AWS_ACCESS_KEY_ID and AWS_SECRET_ACCESS_KEY are required. AWS_REGION and S3_BUCKET_NAME are optional.

What IAM permissions are needed?

Minimum required permissions are s3:ListBucket and s3:GetObject on the specified S3 bucket.

What MCP functions are available?

Two functions: listObjects (optional prefix parameter) and getObject (required key parameter). getObject returns content as a ReadableStream along with metadata.

Does S3 MCP Server handle large files?

Yes, it is optimized for large files through streaming, including PDF files, and returns a text buffer of the raw PDF ByteArray.

Frequently asked questions

How do I install S3 MCP Server?

Install via `npx -y @geunoh/s3-mcp-server`. No additional dependencies are required.

What environment variables are required?

`AWS_ACCESS_KEY_ID` and `AWS_SECRET_ACCESS_KEY` are required. `AWS_REGION` and `S3_BUCKET_NAME` are optional.

What IAM permissions are needed?

Minimum required permissions are `s3:ListBucket` and `s3:GetObject` on the specified S3 bucket.

What MCP functions are available?

Two functions: `listObjects` (optional `prefix` parameter) and `getObject` (required `key` parameter). `getObject` returns content as a `ReadableStream` along with metadata.

Does S3 MCP Server handle large files?

Yes, it is optimized for large files through streaming, including PDF files, and returns a text buffer of the raw PDF ByteArray.

Comments

Basic information

More Files & Storage MCP servers

File Context Server

bsmi021

A Model Context Protocol (MCP) server that provides file system context to Large Language Models (LLMs). This server enables LLMs to read, search, and analyze code files with advanced caching and real-time file watching capabilities.