AWS S3

🚀 AWS S3 MCP サーバー

AWS S3 操作のための安全なアクセスサーバーです。事前署名付き URL を通じて、S3 バケットへの安全なアクセスを提供します。

✨ 主な機能

ツール

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 ブール値

🔧 環境変数

サーバーには以下の環境変数が必要です。

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 .

🔧 技術詳細

サーバーは以下の技術を使用して構築されています。

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

📄 ライセンス

この MCP サーバーは MIT License に基づいて配布されています。これは、あなたが自由にソフトウェアを使用、変更、配布できることを意味しますが、MIT License の条項と条件に従う必要があります。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。