S3 Tools

🚀 s3工具 MCP サーバ

このサーバは、AWS S3 バケットとのインタラクションを可能にするツールを提供する MCP サーバです。Model Context Protocol を通じて、S3 バケット操作への直接アクセスを実現しています。

✨ 主な機能

ツール

現在実装されているツールは以下の通りです。

• list-s3-buckets: あなたの AWS アカウント内のすべての S3 バケットをリストします。
  • オプションで region パラメータを指定して、AWS リージョンを指定できます。
  • 整形されたバケット名のリストを返します。

📋 前提条件

• Python 3.13 以上
• 設定済みの AWS クレデンシャル（AWS クレデンシャル設定 を参照）
• uv パッケージマネージャー

📦 インストール

PyPI からのインストール

uvx インストール s3-tools

ソースコードからのインストール

1. リポジトリをクローンします。
2. uv を使用してインストールします。

uv pip インストール .

AWS クレデンシャル設定

このサーバは、S3 バケットにアクセスするために AWS クレデンシャルが必要です。クレデンシャルは以下の方法で設定できます。

1. AWS CLI 設定（推奨）

   aws 設定
   

   これにより、~/.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"  # オプション
   

3. IAM ロール（AWS インフラストラクチャ上で実行する場合）

詳細な AWS クレデンシャル情報については、AWS ドキュメント を参照してください。

🛠️ 設定

Claude Desktop

サーバの設定を 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: --token または UV_PUBLISH_TOKEN
• またはユーザー名/パスワード: --username/UV_PUBLISH_USERNAME および --password/UV_PUBLISH_PASSWORD

デバッグ

MCP サーバは stdio を通じて通信するため、デバッグは難しい場合があります。開発には MCP Inspector の使用をおすすめします。

npx @modelcontextprotocol/inspector uv run s3-tools

📄 ライセンス

MIT

🤝 貢献

貢献を歓迎します！自由に Pull Request を送信してください。