CHUK MCP S3 Bucket Manager
Overview
The CHUK MCP S3 Bucket Manager is a Python-based tool for managing Amazon S3 buckets using the MCP (Model Context Protocol) runtime. This utility provides a simple interface for listing, creating, and deleting S3 buckets.
Features
- List all S3 buckets
- Create new S3 buckets
- Delete existing S3 buckets
- Optional force deletion of buckets (clearing all objects)
- Supports custom AWS endpoint and region configuration
Prerequisites
- Python 3.11+
- AWS credentials configured
- Required dependencies (installed automatically via pip)
Installation
You can install the package directly from the repository:
pip install git+https://github.com/chrishayuk/chuk-mcp-s3-bucket-manager.git
Configuration
Environment Variables
AWS_ENDPOINT_URL_S3: Optional custom S3 endpoint URLAWS_REGION: AWS region (defaults to us-east-1)
Configuration File
The project uses a config.yaml file to configure the MCP server settings:
host:
name: "chuk-mcp-s3-bucket-manager"
log_level: "INFO"
server:
type: "stdio"
mcp_servers:
s3_bucket_manager:
enabled: true
location: "."
tools:
enabled: true
module: "chuk_mcp_s3_bucket_manager.tools"
Usage
Command-Line Interface
# List buckets
chuk-mcp-s3-bucket-manager list_buckets
# Create a new bucket
chuk-mcp-s3-bucket-manager create_bucket --bucket_name my-new-bucket
# Delete a bucket
chuk-mcp-s3-bucket-manager delete_bucket --bucket_name my-bucket
# Force delete a bucket (remove all objects first)
chuk-mcp-s3-bucket-manager delete_bucket --bucket_name my-bucket --force
Programmatic Usage
from chuk_mcp_s3_bucket_manager import tools
# List buckets
buckets = tools.list_buckets()
# Create a bucket
result = tools.create_bucket("my-new-bucket")
# Delete a bucket
result = tools.delete_bucket("my-bucket", force=False)
Development
Setup
- Clone the repository
- Create a virtual environment
- Install development dependencies:
pip install -e .[dev]
Running Tests
pytest tests/
Dependencies
- boto3
- chuk-mcp-runtime
- pydantic
- PyYAML
License
[Specify your license here]
Contributing
Contributions are welcome! Please submit pull requests or open issues on the GitHub repository.
Support
For issues or questions, please file an issue on the GitHub issue tracker.
Metadata
Release files for chuk-mcp-s3-bucket-manager 0.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| chuk_mcp_s3_bucket_manager-0.1.1-py3-none-any.whl | Python 3 | none | any | Details for chuk_mcp_s3_bucket_manager-0.1.1-py3-none-any.whl |
Release files / chuk_mcp_s3_bucket_manager-0.1.1-py3-none-any.whl
| Download URL | chuk_mcp_s3_bucket_manager-0.1.1-py3-none-any.whl |
|---|---|
| Size | 3.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
7d83164958a0152cf47f2a1bdcf8ffc8e5c014d69034d5b7a4bd2dd7211835b8
|
|
BLAKE2b-256 checksum How to use checksums |
849907bd10300fe2165406a8c2ace529edb64bbe04259fe4b363f11bb525dabd
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.1.0 CPython/3.12.2
|
Security for chuk-mcp-s3-bucket-manager 0.1.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.