AWS S3

🚀 AWS S3 MCP 服務端

AWS S3 MCP 服務端是一個用於 AWS S3 操作的安全訪問服務器，它通過預簽名 URL 提供對 S3 存儲桶的安全訪問，保障數據操作的安全性與便捷性。

🚀 快速開始

環境變量配置

服務器需要以下環境變量：

• BUCKET_NAME：你的 S3 存儲桶名稱（必需）
• REGION：AWS 區域（默認："ap-southeast-1"）

AWS 憑證應通過標準 AWS 憑證配置方法進行配置（環境變量、IAM 角色或 AWS 憑證文件）。

使用與 Claude Desktop

在你的 claude_desktop_config.json 中添加以下內容：

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BUCKET_NAME",
        "-e",
        "REGION",
        "-e",
        "AWS_ACCESS_KEY_ID",
        "-e",
        "AWS_SECRET_ACCESS_KEY",
        "mcp/aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

NPX 命令

{
  "mcpServers": {
    "aws-ow-s3-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-aws-ow-s3-mcp"
      ],
      "env": {
        "BUCKET_NAME": "<YOUR_BUCKET_NAME>",
        "REGION": "<AWS_REGION>",
        "AWS_ACCESS_KEY_ID": "<YOUR_ACCESS_KEY>",
        "AWS_SECRET_ACCESS_KEY": "<YOUR_SECRET_KEY>"
      }
    }
  }
}

構建

使用 Docker 構建：

docker build -t mcp/aws-ow-s3-mcp-server .

✨ 主要特性

工具列表

1. list_objects

   • 功能：列出存儲桶中的對象
   • 輸入：
     • prefix (字符串，可選)：對象鍵的前綴過濾器
   • 返回：包含鍵、大小和最後修改日期的對象數組

2. get_object

   • 功能：為獲取對象生成預簽名 URL
   • 輸入：
     • key (字符串，必需)：要檢索的對象鍵
     • expiry (數字，可選)：URL 的過期時間（單位：秒，默認：3600）
   • 返回：包含預簽名 URL 的 object_url

3. put_object

   • 功能：為上傳對象生成預簽名 URL
   • 輸入：
     • key (字符串，必需)：要上傳的對象鍵
     • expiry (數字，可選)：URL 的過期時間（單位：秒，默認：3600）
   • 返回：包含上傳 URL 的 upload_url

4. delete_object

   • 功能：從存儲桶中刪除對象
   • 輸入：
     • key (字符串，必需)：要刪除的對象鍵
   • 返回：success 布爾值，指示刪除狀態

🔧 技術細節

服務器使用以下技術構建：

• Node.js
• TypeScript
• @modelcontextprotocol/sdk
• @aws-sdk/client-s3
• @aws-sdk/s3-request-presigner

📄 許可證

該 MCP 服務端根據 MIT License 分發。這意味著你可以自由地使用、修改和分發軟件，但需遵守 MIT License 的條款和條件。更多詳細信息，請參閱項目倉庫中的 LICENSE 文件。