S3 MCP

🚀 S3 MCP服務器

此服務器可助力您高效管理S3桶和對象，處理生命週期配置，設置與檢索對象標籤，管理存儲桶策略以及配置CORS設置，為您的S3資源管理提供全方位支持。

🚀 快速開始

此服務器允許您執行以下操作：

• 管理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規則。
• 配置示例：查看如何在實際場景中使用此服務器。

💻 使用示例

基礎用法

# 示例Python代碼
def list_buckets():
    # 連接到S3服務
    s3 = boto3.client('s3')
    # 獲取所有存儲桶
    buckets = s3.list_buckets()
    # 打印存儲桶名稱
    for bucket in buckets['Buckets']:
        print(bucket['Name'])

list_buckets()

高級用法

# 示例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 進行許可。