S3 MCP

🚀 S3-MCPサーバー

このサーバーは、以下の操作を実行することを可能にします。

• S3バケットとオブジェクトを管理する
• ライフサイクル設定を処理する
• オブジェクトタグを設定および取得する
• バケットポリシーを管理する
• CORS設定を構成する

🚀 クイックスタート

このサーバーは、あなたの設定に応じて、いくつかの方法で使用することができます。

📦 インストール

Cursorを使用する（推奨）

以下の内容をあなたのCursor MCP設定に追加してください。

{
  "mcpServers": {
    "s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "AWS_SECRET_ACCESS_KEY=your_access_key",
        "-e",
        "AWS_ACCESS_KEY_ID=your_access_key",
        "-e",
        "AWS_REGION=your_region",
        "ashgw/s3-mcp:latest"
      ]
    }
  }
}

⚠️ 重要提示

特定のDockerイメージビルド（例：20250413 - 165732）に固定したい場合は、latestの代わりにそのタグを使用してください。 Docker Hub で利用可能なバージョンを確認してください。

Cursorは自動的にリクエストをMCPサーバーにルーティングします。すべてのツールが正常に動作し、緑色の状態であることを確認してください。

Docker（手動）

Dockerを使用してS3 MCPサーバーを手動で実行することができます。

docker run --rm -it \
  -e AWS_ACCESS_KEY_ID=your_access_key \
  -e AWS_SECRET_ACCESS_KEY=your_secret_key \
  -e AWS_REGION=your_region \
  ashgw/s3-mcp

このコマンドは、 ashgw/s3-mcp に公開されている事前構築済みのイメージを使用します。

ソースコードリポジトリ

リポジトリをクローンし、cdでそのディレクトリに移動した後、以下のコマンドでビルドします。

docker build -t s3-mcp .

その後、以下のコマンドで実行します。

docker run --rm -e AWS_ACCESS_KEY_ID=your_access_key -e AWS_SECRET_ACCESS_KEY=your_secret_key -e AWS_REGION=your_region s3-mcp

環境変数

AWS資格情報を構成するために、以下の環境変数を設定してください。

export AWS_ACCESS_KEY_ID=your_access_key
export AWS_SECRET_ACCESS_KEY=your_secret_key
export AWS_REGION=your_region

✨ 主な機能

• バケットの一覧表示：すべてのS3バケットのリストを取得します。
• バケットの作成：新しいS3バケットを作成し、必要に応じて設定を行います。
• オブジェクトの一覧表示：指定されたバケット内のすべてのオブジェクトをリストします。
• オブジェクトの取得：指定されたオブジェクトの内容を取得します。
• オブジェクトのアップロード：オブジェクトを指定されたバケットにアップロードします。
• オブジェクトの削除：指定されたバケットからオブジェクトを削除します。
• 事前署名URLの生成：オブジェクトにアクセスまたはアップロードするための事前署名URLを作成します。
• バケットポリシーの設定：指定されたバケットのポリシーを更新または設定します。
• バケットポリシーの取得：指定されたバケットの現在のポリシーを取得します。
• バケットポリシーの削除：指定されたバケットの現在のポリシーを削除します。
• ライフサイクル設定：S3バケットのライフサイクルルールを管理します。
• オブジェクトタグ付け：S3オブジェクトのタグを設定および取得します。
• CORS設定：バケットのCORSルールを取得および設定します。
• 設定例：このサーバーを実際のシナリオで使用する方法を確認します。

💻 使用例

基本的な使用法

例1：すべてのバケットを一覧表示する

# 示例Python代码
def list_buckets():
    # 连接到S3服务
    s3 = boto3.client('s3')
    # 获取所有存储桶
    buckets = s3.list_buckets()
    # 打印存储桶名称
    for bucket in buckets['Buckets']:
        print(bucket['Name'])

list_buckets()

例2：新しいバケットを作成する

# 示例Python代码
def create_bucket():
    # 创建S3客户端
    s3 = boto3.client('s3')
    # 定义存储桶配置
    bucket_config = {
        'LocationConstraint': 'us-west-2'
    }
    # 创建存储桶
    response = s3.create_bucket(
        Bucket='my-new-bucket',
        CreateBucketConfiguration=bucket_config
    )
    # 打印创建结果
    print(response)

create_bucket()

📄 ライセンス

このプロジェクトは MIT License の下でライセンスされています。