S3 MCP Server
@Geun-Oh
⚙️ 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.
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.
