Aws S3 MCP

🚀 S3 サーバーユーザーガイド

このガイドでは、S3 サーバーのインストール、設定、使用方法について詳しく説明します。また、Claude デスクトップアプリケーションとの統合についても解説します。

🚀 クイックスタート

本ガイドを通じて、S3 サーバーのインストール、設定、使用方法を学び、Claude デスクトップアプリケーションとの統合を行うことができます。

✨ 主な機能

• 様々なオペレーティングシステムでの動作が可能です。
• 複数の S3 バケットの操作をサポートしています。
• Claude デスクトップアプリケーションとの統合が可能です。

📦 インストール

システム要件

• オペレーティングシステム：Linux、macOS、Windows
• メモリ：少なくとも 512MB RAM
• ディスク空間：少なくとも 1GB の空き容量
• その他：AWS 認証情報が必要です。

インストール手順

1. コードリポジトリをクローンします：

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

2. 依存関係をインストールします：

   npm install
   

📚 ドキュメント

設定ガイド

環境変数の設定

config.json ファイルを編集し、以下の内容を追加します。

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

サーバーの起動

npm start

機能概要

ツールリスト

バケットの一覧表示 (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...

セキュリティに関する注意事項

• サーバーは S3_BUCKETS 環境変数で指定されたバケットのみにアクセスします。
• AWS 認証情報には適切な権限が必要です。
• IAM 権限を最小特権の原則で設定することをおすすめします。
• 本番環境では、IAM ロールを使用して S3 アクセスを制限することを検討してください。

Claude との統合

デスクトップアプリケーションでは、ユーザーは以下の操作を要求できます。

• "すべての私の S3 バケットをリストする"
• "my-documents-bucket 内の PDF ファイルを要約する"
• "my-documents-bucket 内の README.txt ファイルを取得する"

Claude は対応する MCP ツールを使用して要求を完了し、結果を表示します。

まとめ

以上の手順に従うことで、ユーザーは S3 サーバーをスムーズに設定および使用し、Claude デスクトップアプリとの統合を実現できます。さらなる支援が必要な場合は、公式ドキュメントを参照するか、技術サポートにお問い合わせください。