S3 Tools

🚀 S3 Tools MCP Server

An MCP server that provides tools for interacting with AWS S3 buckets. This server enables direct access to S3 bucket operations through the Model Context Protocol.

🚀 Quick Start

The S3 Tools MCP Server offers a convenient way to interact with AWS S3 buckets. It allows you to perform operations such as listing S3 buckets directly through the Model Context Protocol.

✨ Features

Tools

The currently implemented tools are as follows:

• list-s3-buckets: Lists all S3 buckets in your AWS account.
  • Optional region parameter to specify the AWS region.
  • Returns a formatted list of bucket names.

📦 Installation

Prerequisites

• Python 3.13 or higher.
• Configured AWS credentials (see AWS Credential Setup).
• uv package manager.

From PyPI

uvx install s3-tools

From Source

1. Clone the repository.
2. Install using uv:

uv pip install .

AWS Credential Setup

This server requires AWS credentials to access your S3 buckets. You can configure the credentials in the following ways:

1. AWS CLI Configuration (Recommended)

   aws configure
   

   This will create/update the credentials in ~/.aws/credentials.

2. Environment Variables

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

3. IAM Role (If running on AWS infrastructure)

For more information on AWS credentials, refer to the AWS Documentation.

Configuration

Claude Desktop

Add the server configuration to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%/Claude/claude_desktop_config.json

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

Development Configuration

For development/testing, you can run the server directly from the source code:

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

🔧 Technical Details

Build

1. Synchronize dependencies:

uv sync

2. Build the package:

uv build

Publish

To publish to PyPI:

uv publish

Note: You need to configure your PyPI credentials via:

• Token: --token or UV_PUBLISH_TOKEN
• Or username/password: --username/UV_PUBLISH_USERNAME and --password/UV_PUBLISH_PASSWORD

Debugging

Since the MCP server communicates via stdio, debugging can be challenging. We recommend using MCP Inspector for development:

npx @modelcontextprotocol/inspector uv run s3-tools

📄 License

This project is licensed under the MIT License.

💡 Contribution

Contributions are welcome! Feel free to submit a Pull Request.