s3-tools

Provides MCP access to AWS S3 operations with the ability to list all buckets and perform bucket-related tasks from a single tool.

python

GitHub Stars

python

Language

6 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-sofianhamiti_mcp-server-s3": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "AKIAEXAMPLEKEY",
        "AWS_DEFAULT_REGION": "us-west-2",
        "AWS_SECRET_ACCESS_KEY": "wJalrXUtnFExampleSecret"
      }
    }
  }
}

You can interact with your AWS S3 buckets through a dedicated MCP server that exposes bucket operations as reusable tools. This server lets you list your buckets directly from MCP clients and integrate S3 actions into your automated workflows, scripts, or chat-enabled workflows.

How to use

To use s3-tools from an MCP client, first start the MCP server configuration that runs locally. Once the server is up, you can invoke the available tools from your client interface. The primary tool provided is list-s3-buckets, which fetches all S3 bucket names in your account and can optionally target a specific AWS region. Use this to quickly discover your bucket landscape and feed the results into further MCP actions or automation steps.

How to install

Prerequisites you need before installing include Python 3.13 or higher and the uv package manager.

Install from PyPI using the uvx tool.

uvx install s3-tools

If you prefer to install from source, follow these steps to set up the server locally with uv.

# Clone the repository
# git clone <repository-url>

# Install using uv
uv pip install .

For development and testing, you can run the server directly from your project directory using the development configuration shown below.

{
  "mcpServers": {
    "s3_tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ]
    }
  }
}

Configuration and credentials

This server requires AWS credentials to access your S3 buckets. You can configure credentials in several ways. One recommended method is configuring via the AWS CLI.

aws configure

This creates or updates credentials in your ~/.aws/credentials file.


Alternatively, you can provide credentials through environment variables. Use the following variables to configure access and, optionally, a default region.

export AWS_ACCESS_KEY_ID="your_access_key" export AWS_SECRET_ACCESS_KEY="your_secret_key" export AWS_DEFAULT_REGION="your_preferred_region" # optional


If you are running on AWS infrastructure with an IAM role, that role will grant the necessary permissions automatically.

## Development

The MCP server can be run in development mode directly from source. Use the development configuration to start the server in your local environment.

{ "mcpServers": { "s3_tools": { "command": "uv", "args": [ "--directory", "/path/to/s3-tools", "run", "s3-tools" ] } } }

## Notes and troubleshooting

Debugging is streamlined when using MCP Inspector during development. It helps visualize the flow between your client and the local MCP server.

## Available tools

### list-s3-buckets

Lists all S3 buckets in your AWS account. Accepts an optional region parameter to target a specific AWS region and returns a formatted list of bucket names.

Built by

VeilStrat

AI signals for GTM teams