ENGRZULQARNAIN/mcp_S3_server
If you are the rightful owner of mcp_S3_server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This repository provides an implementation of a Model Context Protocol (MCP) server for AWS S3, enabling AI models to securely interact with S3 buckets.
Model Context Protocol (MCP) Server for AWS S3
This repository provides an implementation of a Model Context Protocol (MCP) server for AWS S3, enabling AI models, particularly Large Language Models (LLMs), to securely interact with S3 buckets. The server offers a standardized interface to list S3 buckets, list objects within buckets, and download file contents. It facilitates seamless integration between AI applications and AWS S3 storage for efficient data retrieval and management.
Key Features
- List S3 Buckets: Retrieve a list of available buckets in an AWS account.
- List Objects: Display objects within a specified bucket.
- File Download: Fetch the contents of specific objects, such as documents or other files.
- Secure Interaction: Provides a standardized, secure interface for AI models to interact with S3.
- MCP Ecosystem: Part of the Model Context Protocol ecosystem, supporting AI model integration with various data sources.
Use Cases
- Data Analysis: Access and analyze data stored in S3 buckets for AI-driven applications.
- Document Retrieval: Retrieve specific files (e.g., PDFs) for processing by AI models.
- Automation: Automate S3 bucket management tasks via natural language queries with LLMs.
- AI Development: Support development of AI models requiring access to external data sources.
Prerequisites
To use this server, developers need:
- Python 3.10 or higher
- Configured AWS credentials (Access Key ID, Secret Access Key, and Region)
- uv package manager (recommended) or pip
- Familiarity with the Model Context Protocol for AI application integration
Limitations
Some implementations may:
- Support only specific file types (e.g., PDFs in certain versions).
- Have limits on the number of retrieved objects (e.g., up to 1000 objects).
- Require specific configurations, such as the maximum number of buckets to return.
Installation and Usage
Option 1: Install from PyPI (Recommended)
# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh # Unix/macOS
# or for Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
# Install the MCP S3 server
uv add mcp-s3-server
# Or using pip
pip install mcp-s3-server
Option 2: Development Installation
# Clone the repository
git clone https://github.com/ENGRZULQARNAIN/mcp_s3_server.git
cd mcp_s3_server
# Install with uv (recommended)
uv sync
# Or install with pip
pip install -e .
Configuration and Usage
-
Configure AWS credentials using one of these methods:
- AWS credentials file (
~/.aws/credentials) - Environment variables (
AWS_ACCESS_KEY_ID,AWS_SECRET_ACCESS_KEY,AWS_DEFAULT_REGION) - IAM roles (for EC2 instances)
- AWS credentials file (
-
Start the server:
mcp-s3-server -
Integrate with an AI model or application using the MCP interface.
Refer to the repository's documentation for detailed setup instructions and API usage.
Contributing
Contributions are welcome! Please read the file for guidelines on submitting issues, feature requests, or pull requests.
License
This project is licensed under the . See the LICENSE file for details.
