AWS S3 AccessTool

by abdullahsayyad

1 398 downloads Not rated yet MIT

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

License: MIT

Explore

- ✅ 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:

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 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.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Ensure you have the following dependencies installed:

pip install aioboto3 mcp[cli] python-dotenv

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

- Configuration for Cursor.ai

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

}
}
}

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.

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"
        ]
    }
}

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

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

Email sign in

No reviews posted yet.

About

Details

Explore

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Key Features

Requirements

Environment Setup

MCP Client Configuration

License ⚖️

More like this

Sequential Thinking

Filesystem

EverArt

Google Drive