S3 Tools

Provides an MCP server to list AWS S3 buckets and interact with S3 via a simple tool interface.

python

0

GitHub Stars

python

Language

7 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": {
    "sofianhamiti-mcp-server-s3": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ],
      "env": {
        "AWS_ACCESS_KEY_ID": "YOUR_ACCESS_KEY",
        "AWS_DEFAULT_REGION": "optional_region",
        "AWS_SECRET_ACCESS_KEY": "YOUR_SECRET_KEY"
      }
    }
  }
}

You can run a dedicated MCP server that exposes AWS S3 bucket interactions through a simple tool interface. This server lets you list your S3 buckets and extend operations in your MCP client workflows, using your AWS credentials to access your account securely.

How to use

Connect to the s3-tools MCP server from your MCP client and call the available tool to list S3 buckets. The primary tool is list-s3-buckets. You can optionally specify a region to narrow the results to a specific AWS region. The server uses your configured AWS credentials to access your buckets, so make sure those credentials are available in your environment before making requests.

How to install

Prerequisites you need before installing the MCP server are Python 3.13 or higher and the uv package manager.

Install from PyPI using uvx:

uvx install s3-tools

Install from source by first installing the package through uv and then adding the local package with pip, as shown here:

uv pip install .

If you plan to run and develop locally, you can also prepare a development configuration that starts the server from the source directory. The following example shows how to run the server via uv while pointing to your local path:

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

Additional configuration and examples

You can also configure the server in a desktop client profile to simplify startup. Below is a typical JSON snippet you would place in your desktop config. This example assumes you start the MCP server using uvx and the client will reference it by the name s3-tools. The exact path and profile name may vary by your environment.

{
  "mcpServers": {
    "s3-tools": {
      "command": "uvx",
      "args": ["s3-tools"]
    }
  }
}

Development and debugging

For development and debugging, you can run the server directly from the source and inspect its MCP interactions with the MCP Inspector. This helps you verify tool behavior during development.

npx @modelcontextprotocol/inspector uv run s3-tools

Available tools

list-s3-buckets

Lists all S3 buckets in your AWS account with an optional region filter. Returns a formatted list of bucket names.