AWS S3 AccessTool

🚀 AWS S3 Access Tool (for MCP Customers) 🪣⚙️

This tool is an AWS S3 bucket utility built for MCP servers, supporting seamless interaction with S3 storage. It enables LLMs to list available buckets, retrieve stored objects, and filter CSV files, with built - in asynchronous support using aioboto3. Developers can integrate it locally or deploy it via Docker. The tool is optimized to make S3 access smoother and more scalable.

https://github.com/user-attachments/assets/976dce46-6ee3-4c1a-b5eb-8ca1575df099

This tool supports environment - based bucket selection, which means you can restrict access to specific buckets through the .env file.

🚀 Quick Start

This AWS S3 access tool simplifies the process of interacting with S3 storage for MCP customers. With just a few steps, you can start leveraging its features.

✨ Features

• ✅ List available S3 buckets
• ✅ Retrieve objects from specific or all buckets
• ✅ Filter and retrieve CSV files
• ✅ Read the contents of CSV files in S3

📦 Installation

Ensure you have the following dependencies installed:

pip install aioboto3 mcp[cli] python-dotenv

📚 Documentation

Environment Configuration

AWS_ACCESS_KEY_ID=Your access key
AWS_SECRET_ACCESS_KEY=Your secret key
AWS_REGION=Your region
S3_BUCKETS=bucket1,bucket2  # (Optional) List of buckets to access

MCP Client Configuration

• Configuration example (for Cursor.ai)

{
    "mcpServers": {
        "AWS-S3-AccessTool": {
            "command": "python",
            "args": ["C:Your absolute path to the file\\main.py"]
        }
    }
}

📄 License

This project is open - source and available under the MIT License.