Mcp_server_s3_download_files
About
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
Details
- Author
- ENGRZULQARNAIN
- GitHub stars
- 4
- Downloads
- 365
- Categories
- Other, AI
Jump to
- List S3 buckets in an AWS account.
- List objects within a specified bucket.
- Download contents of specific objects (e.g., files).
- Secure, standardized interface for AI models.
- Part of the Model Context Protocol ecosystem.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Mcp_server_s3_download_filesCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install the server via PyPI using uv add mcp-s3-server (recommended) or pip install mcp-s3-server. For a development install, clone the repository and run uv sync or pip install -e .. Configure AWS credentials using the credentials file, environment variables, or IAM roles. Start the server by running the mcp-s3-server command, then integrate with an AI model via the MCP interface.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp_server_s3_download_files": {
"mcp_server_s3_download_files": {
"command": "uv",
"args": [
"sync"
]
}
}
}
}McpServers
{
"mcp_server_s3_download_files": {
"command": "uv",
"args": [
"sync"
]
}
}
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 integrationLimitations
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
1. 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)
2. Start the server:
mcp-s3-server
3. 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 CONTRIBUTING.md file for guidelines on submitting issues, feature requests, or pull requests.License
This project is licensed under the MIT License. See the LICENSE file for details.Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
