Aws S3 MCP

🚀 S3 服務器用戶指南

本指南詳細介紹瞭如何安裝、配置和使用 S3 服務器，還涵蓋了與 Claude 桌面應用程序的集成方法，幫助你快速上手並高效使用 S3 服務器。

🚀 快速開始

本指南將引導你完成 S3 服務器的安裝、配置和使用，同時介紹與 Claude 桌面應用程序的集成。

✨ 主要特性

• 支持多種操作系統，包括 Linux、macOS 和 Windows。
• 提供豐富的工具，如列出桶、列出對象和獲取對象等功能。
• 可與 Claude 桌面應用程序集成，方便用戶操作。

📦 安裝指南

系統要求

• 操作系統：Linux、macOS、Windows
• 內存：至少 512MB RAM
• 磁盤空間：至少 1GB 可用空間
• 其他：需要 AWS 憑證

安裝步驟

1. 克隆代碼倉庫：

   git clone https://github.com/your-repository.git
   cd s3-server
   

2. 安裝依賴項：

   npm install
   

💻 使用示例

基礎用法

列出桶 (list-buckets)

列出當前用戶有權限訪問的所有 S3 桶，結果基於 S3_BUCKETS 環境變量。

[
  {
    "Name": "my-images-bucket",
    "CreationDate": "2022-03-15T10:30:00.000Z"
  },
  {
    "Name": "my-documents-bucket",
    "CreationDate": "2023-05-20T14:45:00.000Z"
  }
]

列出對象 (list-objects)

列出指定 S3 桶中的所有對象，支持前綴和最大數量的過濾。

# 參數說明
# - `bucket`（必填）：目標 S3 桶名稱
# - `prefix`（可選）：用於篩選對象的前綴
# - `maxKeys`（可選）：限制返回的對象數量

示例輸出：

[
  {
    "Key": "sample.pdf",
    "LastModified": "2023-10-10T08:12:15.000Z",
    "Size": 2048576,
    "StorageClass": "STANDARD"
  },
  {
    "Key": "sample.md",
    "LastModified": "2023-10-12T15:30:45.000Z",
    "Size": 1536000,
    "StorageClass": "STANDARD"
  }
]

獲取對象 (get-object)

從指定 S3 桶中獲取單個對象，文本文件返回為純文本，二進制文件返回基礎信息。

# 參數說明
# - `bucket`（必填）：目標 S3 桶名稱
# - `key`（必填）：目標對象的鍵

示例輸出： 文本文件：

This is the content of a text file stored in S3.
It could be JSON, TXT, CSV or other text-based formats.

二進制文件：

Binary content (image/jpeg): base64 data是 /9j/4AAQSkZJRgABAQAAAQABAAD/2wBDAAgGBgcGBQgHBwcJCQgKDBQNDAsLDBkSEw8UHRof...

📚 詳細文檔

配置指南

環境變量配置

編輯 config.json 文件，添加以下內容：

{
  "aws": {
    "accessKeyId": "YOUR_ACCESS_KEY_ID",
    "secretAccessKey": "YOUR_SECRET_ACCESS_KEY",
    "region": "your-region"
  },
  "s3": {
    "buckets": ["bucket1", "bucket2"],
    "maxKeys": 100
  }
}

啟動服務器

npm start

與 Claude 的集成

在桌面應用程序中，用戶可以請求執行以下操作：

• "列出所有我的 S3 桶"
• "總結 my-documents-bucket 中的 PDF 文件"
• "獲取 my-documents-bucket 中的 README.txt 文件"

Claude 將使用相應的 MCP 工具完成請求並展示結果。

🔧 技術細節

安全注意事項

• 服務器僅訪問 S3_BUCKETS 環境變量中指定的桶。
• AWS 憑證必須具有適當的權限。
• 建議使用最小特權原則配置 IAM 權限。
• 生產環境中，請考慮使用 IAM 角色限制 S3 訪問。

結語

通過以上步驟，用戶能夠順利配置和使用 S3 服務器，並實現與 Claude 桌面應用的集成。如需進一步幫助，請參考官方文檔或聯繫技術支持。