Mcp Server S3

mcp-server-s3

AI アシスタントから AWS S3 のバケットとオブジェクトを管理できます。ファイルの閲覧、コンテンツのアップロードとダウンロード、署名付き URL の生成が可能です。

npx mcp-server-s3

Claude Desktop、Cursor、VS Code Copilot、およびあらゆる MCP クライアントで動作します。既存の AWS 認証情報（~/.aws/credentials または環境変数）を使用します。

_{remotion-readme-kitで作成したデモ}

概要

S3 は最も広く使われているクラウドストレージサービスですが、コマンドラインから管理するには、aws s3 ls、aws s3 cp、署名付き URL の構文、さまざまなフラグを覚えておく必要があります。Google には GCS 用の公式 MCP があり、Cloudflare には R2 用のものがありますが、AWS S3 には npm で洗練されたスタンドアロンの MCP サーバーがありません。このサーバーを使えば、アシスタントにバケットの一覧表示、設定ファイルのダウンロード、コンテンツのアップロード、一時的な共有リンクの生成を依頼できます。標準の AWS 認証情報チェーンを使用するため、CLI がすでに動作していれば、こちらも動作します。

ツール

ツール	機能
list_buckets	AWS アカウント内のすべての S3 バケットを一覧表示します。
list_objects	バケット内のオブジェクトを一覧表示します。オプションでプレフィックスによる絞り込みができます。
get_object	オブジェクトのコンテンツをテキストとしてダウンロードして読み取ります。
put_object	テキストコンテンツを S3 オブジェクトにアップロードします。
delete_object	バケットからオブジェクトを削除します。
presigned_url	オブジェクトの一時的な署名付き URL を生成します。
bucket_info	バケットが存在するか確認し、基本情報を取得します。

クイックスタート

Cursor

.cursor/mcp.json に追加します。

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

Claude Desktop

claude_desktop_config.json に追加します（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

{
  "mcpServers": {
    "s3": {
      "command": "npx",
      "args": ["mcp-server-s3"],
      "env": {
        "AWS_REGION": "us-east-1",
        "AWS_ACCESS_KEY_ID": "your-access-key",
        "AWS_SECRET_ACCESS_KEY": "your-secret-key"
      }
    }
  }
}

VS Code

環境変数に AWS_REGION、AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY を設定し、npx mcp-server-s3 を実行するよう MCP サーバーを構成します。

認証

サーバーは標準の AWS 認証情報チェーンを使用します。

1. 環境変数：AWS_ACCESS_KEY_ID、AWS_SECRET_ACCESS_KEY、AWS_REGION
2. 共有認証情報ファイル：~/.aws/credentials
3. IAM ロール：EC2、ECS、Lambda などで実行する場合

AWS_REGION を設定し（デフォルトは us-east-1）、認証情報に必要な S3 権限（s3:ListBuckets、s3:ListBucket、s3:GetObject、s3:PutObject、s3:DeleteObject、s3:HeadBucket）があることを確認してください。

Agent Plugins

このリポジトリは Agent Plugins 1.0.0 パッケージです。plugin.json、ポータブルな mcp.json、skills/ が MCP サーバーとともに含まれています。

Cursor の場合は、リポジトリをクローンし、~/.cursor/plugins/local/mcp-server-s3 にコピーするかシンボリックリンクを作成してから、ウィンドウを再読み込みしてください。スキルと MCP は「Customize」>「Plugins」に表示されます。

Agent Plugins v1 には OAuth や AWS SSO の連携機能は含まれていません。MCP クライアントのホストで、環境変数または ~/.aws/credentials を使って AWS_REGION と認証情報を設定してください。シークレットは環境変数で管理するため、ワンクリックインストールは提供していません。

よくある質問

mcp-server-s3 とは？

S3 用の MCP サーバーです。バケットとオブジェクトの一覧表示、テキストオブジェクトの読み取りとアップロード、キーの削除、署名付き URL の生成、バケットの確認ができます。

認証はどのように機能しますか？

標準の AWS 認証情報チェーンを使用します。MCP サーバーを実行するマシン上の環境変数、共有認証情報ファイル、または IAM ロールを利用できます。

MCP の設定で、どの環境変数を設定すればよいですか？

最低限、AWS_REGION が必要です。~/.aws/credentials またはロールを利用しない場合は、多くの場合 AWS_ACCESS_KEY_ID と AWS_SECRET_ACCESS_KEY も必要です。

Cursor にエージェントプラグインとしてインストールできますか？

はい。~/.cursor/plugins/local/mcp-server-s3 を使います。Cursor のプロセスが、CLI と同じ AWS 認証情報を読み取れることを確認してください。

Cursor にワンクリックボタンがないのはなぜですか？

AWS キーをポータブルなインストールリンクに埋め込むことはできません。「クイックスタート」の下にある JSON を使用してください。

プロンプトの例

• 「自分の S3 バケットをすべて一覧表示して」
• 「my-bucket/uploads/ にあるファイルを表示して」
• 「my-bucket から config.json をダウンロードして」
• 「この内容を my-bucket/notes.txt にアップロードして」
• 「このファイルの有効期限が 1 時間の署名付き URL を生成して」

開発

npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lint

関連項目

ポートフォリオで、その他の MCP サーバーや開発者向けツールをご覧いただけます。

作者

---

_{README Builder で作成した README です}

ライセンス

MIT © 2026 Ofer Shapira