s3-tools

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

  • Provides tools for interacting with AWS S3 buckets, allowing users to list all S3 buckets in their AWS account with optional region specification.

s3-tools MCP サーバー

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

特徴

ツール

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

  • list-s3-buckets : AWS アカウント内のすべての S3 バケットを一覧表示します
    • AWSリージョンを指定するためのオプションのregionパラメータ
    • バケット名のフォーマットされたリストを返します

前提条件

インストール

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
  1. ビルドパッケージ:
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

ライセンス

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

貢献

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

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

AWS S3 バケットと対話するためのツールを提供し、モデルコンテキストプロトコルを介して S3 操作に直接アクセスできるようにする MCP サーバー。

  1. Features
    1. Tools
  2. Prerequisites
    1. Installation
      1. From PyPI
      2. From Source
    2. AWS Credentials Setup
      1. Configuration
        1. Claude Desktop
        2. Development Configuration
      2. Development
        1. Building
        2. Publishing
        3. Debugging
      3. License
        1. Contributing
          ID: gwm71t70bc