s3-tools MCP サーバー

AWS S3バケットを操作するためのツールを提供するMCPサーバー。このサーバーは、モデルコンテキストプロトコル（MCP）を介してS3バケット操作に直接アクセスすることを可能にします。

特徴

ツール

現在、サーバーは次のツールを実装しています。

• list-s3-buckets : AWS アカウント内のすべての S3 バケットを一覧表示します

  • AWSリージョンを指定するためのオプションのregionパラメータ

  • バケット名のフォーマットされたリストを返します

Related MCP server: AWS S3 Control MCP Server

前提条件

• Python 3.13以上

• AWS 認証情報が設定されている（ AWS 認証情報の設定を参照）

• UVパッケージマネージャー

インストール

PyPIから

uvx install s3-tools

ソースから

1. リポジトリをクローンする

2. uv を使用してインストールします。

uv pip install .

AWS認証情報の設定

このサーバーはS3バケットにアクセスするためにAWS認証情報を必要とします。認証情報はいくつかの方法で設定できます。

1. AWS CLI 設定（推奨）

   aws configure

   これにより~/.aws/credentialsに認証情報が作成/更新されます。

2. 環境変数

   export AWS_ACCESS_KEY_ID="your_access_key"
   export AWS_SECRET_ACCESS_KEY="your_secret_key"
   export AWS_DEFAULT_REGION="your_preferred_region"  # optional

3. IAM ロール(AWS インフラストラクチャ上で実行されている場合)

AWS 認証情報の詳細については、 AWS ドキュメントを参照してください。

構成

クロードデスクトップ

Claude Desktop 構成ファイルにサーバー構成を追加します。

MacOS : ~/Library/Application Support/Claude/claude_desktop_config.json
Windows : %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "s3-tools": {
      "command": "uvx",
      "args": ["s3-tools"]
    }
  }
}

開発構成

開発/テストの場合、ソースから直接サーバーを実行できます。

{
  "mcpServers": {
    "s3-tools": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/s3-tools",
        "run",
        "s3-tools"
      ]
    }
  }
}

発達

建物

1. 同期の依存関係:

uv sync

2. ビルドパッケージ:

uv build

出版

PyPI に公開するには:

uv publish

注: PyPI 資格情報は次のように設定する必要があります。

• トークン: --tokenまたはUV_PUBLISH_TOKEN

• またはユーザー名/パスワード: --username / UV_PUBLISH_USERNAMEおよび--password / UV_PUBLISH_PASSWORD

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが困難になる場合があります。開発にはMCP Inspectorの使用をお勧めします。

npx @modelcontextprotocol/inspector uv run s3-tools

ライセンス

マサチューセッツ工科大学

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。