AWS S3 AccessTool

by abdullahsayyad

1 stars
398 downloads
Not rated
GitHub

About

A tool written in complete python following the MCP(model context protocol). LLM can leverage this tool to work with aws S3 buckets

Details

Author
abdullahsayyad
GitHub stars
1
Downloads
398
Categories
Other, File Management

- List available S3 buckets
- Fetch objects from specific or all buckets
- Filter and retrieve only CSV files
- Read the content of a CSV file from S3

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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name AWS S3 AccessTool
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install dependencies: pip install aioboto3 mcp[cli] python-dotenv. Set environment variables AWS_ACCESS_KEY_ID, AWS_SECRET_ACCESS_KEY, AWS_REGION, and optionally S3_BUCKETS to restrict access. Then configure your MCP client (e.g., Cursor.ai) with the command python and the absolute path to main.py.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

AWS S3 access tool for MCP Clients πŸͺ£βš™οΈ Python License

This tool is an AWS S3 bucket utility built for MCP Server, allowing seamless interaction with S3 storage. It lets LLMs list available buckets, retrieve stored objects, and filter for CSV files, with built-in async support using aioboto3. Developers can integrate either locally or via Docker. The tool is optimized for automation, making S3 access smoother and more scalable. https://github.com/user-attachments/assets/976dce46-6ee3-4c1a-b5eb-8ca1575df099 The tool supports environment-based bucket selection, meaning you can restrict access to specific buckets using an .env file.

Key Features

- βœ… List available S3 buckets - βœ… Fetch objects from specific or all buckets - βœ… Filter and retrieve only CSV files - βœ… Read the content of a CSV file from S3

Requirements

Ensure you have the following dependencies installed: pip install aioboto3 mcp[cli] python-dotenv

Environment Setup

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 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.
No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.