MCP S3 Server

🚀 Object Storage Service MCP

The MCP (Model Context Protocol) server for object storage supports a series of operations for object storage.

🚀 Quick Start

✨ Features

The MCP server supports the following operations:

• list-buckets: List all buckets.
• exists-bucket: Check if a bucket exists.
• create-bucket: Create a new bucket.
• delete-bucket: Delete a bucket.
• list-objects: Query objects under a bucket.
• get-object: Retrieve an object and save it to a local file.
• put-object: Upload a local file to a bucket.
• delete-object: Delete an object.
• get-object-metadata: Get object metadata.

📦 Installation

Environment Requirements

Python >= 3.11

💻 Usage Examples

Basic Usage

1. Pull this project to your local machine.
2. Install dependencies.

uv sync

3. Configure the server in the MCP client.

{
  "mcpServers": {
    "bilibili": {
      "command": "uv",
      "args": [
        "--directory",
        "/your-project-path/src/s3-server",
        "run",
        "server.py"
      ],
      "env": {
        "ENDPOINT": "endpoint",
        "ACCESS_KEY_ID": "your access key",
        "ACCESS_KEY_SECRET": "your access secret"
      }
    }
  }
}