mws-s3-mcp-ai-cli

MWS S3 MCP サーバー＆AI CLI

S3 MWS Cloud Platform 向けの MCP サーバーと CLI です。サービスアカウントの HMAC キーを使って、Claude Code、Cursor、Codex からオブジェクトストレージに接続します。バイナリの mws-s3 では、アクセスを確認したり、バックアップを見つけたり、一時リンクを作成したりできます。

英語ガイド · S3 MCP サーバーのディレクトリ

英語

MWS S3 Object Storage 向けの Go MCP サーバー、CLI、エージェントスキルです。Claude Code、Cursor、Codex を、対象範囲を限定したオブジェクトストレージに接続して、内容の確認やバックアップの復元に利用できます。Cloud Platform、storage.mwsapis.ru。ACL は無効です。英語の完全版ガイドを参照してください。

クイックスタート

このプロファイルは MWS Cloud Platform（storage.mwsapis.ru、ru-central1）向けです。所有者がサービスアカウントの HMAC キーを作成し、その Access key／Secret key を auth set で入力します。presign には 60～604800 秒の有効期間を指定してください。

Releases から使用するプラットフォーム用のバイナリをダウンロードするか（v0.1.0 を公開済み。MCP Registry と Smithery にも掲載）、Go 1.27.2 でビルドしてください。

bash scripts/go.sh go build -o mws-s3 ./cmd/mws-s3
./mws-s3 version
./mws-s3 auth set
./mws-s3 auth status
./mws-s3 ls --json

auth set は key ID と secret の入力を求めますが、入力内容は画面に表示されません。TTY がない場合は stdin から 2 行を読み取ります。secret を argv に渡さないでください。~/.config/mws-s3/credentials ファイルは 0600 の権限でアトミックに作成されます。これより広い権限は拒否されます。

優先順位は、フラグ > env > ファイルです。環境変数は次のとおりです。MWS_S3_ACCESS_KEY_ID、MWS_S3_SECRET_ACCESS_KEY、MWS_S3_POOL（ru-central1）、MWS_S3_ENDPOINT。HTTP を使用するには MWS_S3_ALLOW_INSECURE=1 が必要です。

イメージ：ghcr.io/stufently/mws-s3-mcp-ai-cli:0.1.0。ローカルでのビルド：docker build -t mws-s3 . イメージは uid 65532 で MCP を実行し、CA 証明書を含みます。認証情報はプライベートな環境またはファイルを通じて渡してください。

機能

• プロファイルの範囲内で、ストリーミングによる object CRUD、copy、multipart、presigned URL に対応します。
• バージョン、タグ、CORS、ポリシー、Object Lock configuration は、サポートされている場合に登録されます。
• 範囲を限定したスキャン、診断、JSON、MCP と組み込みスキルのインストールに対応します。

Claude Code、Cursor、Codex への接続

このボタンを使うと、読み取り専用モードで Docker イメージ ghcr.io/stufently/mws-s3-mcp-ai-cli:0.1.0 から MCP をインストールします。キーは設定ファイルに書き込まれません。Cursor は環境変数から ${env:…} を展開するため、Cursor の起動元の環境で MWS_S3_ACCESS_KEY_ID と MWS_S3_SECRET_ACCESS_KEY を設定してください。バケットがデフォルトのプールにない場合は MWS_S3_POOL も設定します（空の値はデフォルトのプールを意味します）。同じブロックを Windsurf（mcp_config.json）と、~/.cursor/mcp.json への手動設定にも使用できます。

{
  "mcpServers": {
    "mws-s3": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MWS_S3_ACCESS_KEY_ID",
        "-e",
        "MWS_S3_SECRET_ACCESS_KEY",
        "-e",
        "MWS_S3_POOL",
        "ghcr.io/stufently/mws-s3-mcp-ai-cli:0.1.0"
      ],
      "env": {
        "MWS_S3_ACCESS_KEY_ID": "${env:MWS_S3_ACCESS_KEY_ID}",
        "MWS_S3_SECRET_ACCESS_KEY": "${env:MWS_S3_SECRET_ACCESS_KEY}",
        "MWS_S3_POOL": "${env:MWS_S3_POOL}"
      }
    }
  }
}

mws-s3 mcp install --client cursor --dry-run
mws-s3 mcp install --client cursor
mws-s3 mcp install --client claude-desktop
mws-s3 mcp install --client codex
mws-s3 mcp install --client claude-code --scope project
mws-s3 mcp install --client claude-code --scope user

最後のコマンドは claude mcp add を表示するだけです。バイナリのパスは絶対パスです。キーは設定ファイルに書き込まれません。Cursor の設定ファイルは ~/.cursor/mcp.json、Claude Code のプロジェクト設定ファイルは ./.mcp.json です。Desktop の場合は、使用する OS の設定ディレクトリを指定してください。JSON の既存キーは保持され、.bak と冪等性にも対応します。

Codex の設定ファイルは ~/.codex/config.toml です。既存のテーブルがある場合は --force が必要です。# >>> mws-s3 (managed) と # <<< mws-s3 (managed) の間のブロックだけが置き換えられます。マーカーのないテーブルは --force を指定しても置き換えられず、TOML のほかのバイト列はそのまま保持されます。

各権限レベルは個別に有効化できます。mws-s3 mcp --allow-write --allow-delete --allow-admin、または MWS_S3_ALLOW=write,delete,admin を指定してください。フラグは mcp install でも使用できます。FILE_ROOT は MWS_S3_FILE_ROOT で有効化できます。

MCP ツール

レベル	ツール
読み取り	s3_list_buckets, s3_list_objects, s3_head_object, s3_get_object, s3_preview_object, s3_presign_get, s3_list_object_versions, s3_list_multipart_uploads, s3_list_parts, s3_get_bucket_config, s3_largest_objects, s3_prefix_usage, s3_unfinished_uploads, s3_get_object_tagging
読み取り + FILE_ROOT	s3_download_file
書き込み	s3_put_object, s3_create_folder, s3_copy_object, s3_presign_put, s3_multipart_create, s3_multipart_presign_part, s3_multipart_complete, s3_put_object_tagging
書き込み + FILE_ROOT	s3_upload_file
削除	s3_delete_object, s3_delete_objects, s3_multipart_abort
管理	s3_create_bucket, s3_put_bucket_versioning, s3_put_bucket_cors, s3_put_bucket_policy, s3_delete_bucket_policy, s3_put_object_lock_configuration
管理 + 削除	s3_delete_bucket

リソース：mws-s3://config、mws-s3://capabilities、mws-s3://pools。サポートされていない機能に対応するツールは除外されます。

リストは continuation_token を使い、最大1000件を返します。バージョン／マルチパートには2つ目のマーカーがあります。インラインの get／put は262144バイト、プレビューは65536バイトまでです。大きなファイルには presigned URL または FILE_ROOT を使用します。応答には structuredContent と JSON テキストが含まれます。テキストが256 KiBを超える場合は、短い要約に置き換えられます。エラーには code/message/retryable が含まれます。429／503の場合、SDKが適応的に再試行します。

分析では最大 max_scan 件（デフォルトは10000件）をスキャンします。partial/token は結果が不完全であることを示します。Prefix usage は next_result_offset を使って集計結果のページを返します。これは課金情報ではありません。

シナリオ：HMACアクセスの確認とアーカイブへの短縮リンク

HMACキーを保存した後、サービスアカウントのアクセスを確認し、MWS Cloud Platform上の既存のアーカイブへの短縮リンクを発行します。この例では、調査で確認された下限に相当する60秒の有効期間を使用します。

mws-s3 auth status
mws-s3 doctor --json
mws-s3 presign backups/daily/archive.tar --expires 60

例では既存のバケット backups とオブジェクト daily/archive.tar を使用します。ご自身の値に置き換えてください。プロファイルとクラウド API については、まだ実環境での確認が必要です。

CLI

mws-s3 mb backups
mws-s3 cp ./archive.tar s3://backups/daily/archive.tar --part-size 5242880 --overwrite --yes
mws-s3 ls backups/daily/ --max-keys 100 --json
mws-s3 stat backups/daily/archive.tar
mws-s3 cp s3://backups/daily/archive.tar ./restored.tar
mws-s3 cp ./directory s3://backups/tree/ --recursive --overwrite --yes
mws-s3 cp s3://backups/tree/ ./restored-directory --recursive
mws-s3 cp s3://backups/daily/archive.tar s3://backups/copy.tar --overwrite --yes
mws-s3 cat backups/daily/notes.txt
mws-s3 versions backups/daily/ --json
mws-s3 du backups/daily/ --max-scan 10000 --json
mws-s3 presign backups/daily/archive.tar --expires 3600
mws-s3 rm backups/copy.tar --yes
mws-s3 rb empty-bucket --yes
mws-s3 doctor --json
mws-s3 compat --markdown

cp は通常のローカルパスと、S3 URI s3://bucket/key または mws-s3://bucket/key を受け付けます。大きなアップロードでは manager／multipart を使用し、--recursive はディレクトリ／プレフィックスをコピーします。上書きには --overwrite と確認が必要です。ダウンロードはアトミックに行われます。TTY 以外では、--yes を指定しない rm/rb/mv はコード2を返します。TTY では確認を求めます。--json は共通オプションです。エラーは stderr に出力され、終了コードは0以外になります。

doctor は、認証情報のソース／権限、DNS／TLS、Date と ListBuckets による時刻を確認します。5分を超える差は警告、15分を超える差はエラーです。

AI エージェント向けスキル

mws-s3 skill install
mws-s3 skill install --target ./agent-skills/mws-s3

デフォルトのインストール先は ~/.claude/skills/mws-s3 です。SKILL.md と6つのリファレンス（バックアップ／復元、共有、最小権限、コスト管理、移行、インシデント対応）を冪等にインストールします。トリガー：「mws s3」、「MWS バケット」、「s3 にアップロード」、「presigned」、「s3 にバックアップ」。

セキュリティ

conditional_writes:false の場合、上書きなしの書き込みは S3 リクエストの前に拒否されます。HEAD ではアトミックな保護ができないためです。一貫性のある書き込みには、CLI で --overwrite --yes、または MCP で overwrite:true, confirm:true を使用し、確認ポリシーを維持してください。conditional_delete:false の場合、mv と s3_move_object は無効になります。

MCP はデフォルトで read のみを登録します。サポートされていない機能と、レベルが指定されていない機能については、ツールが除外されます。

MWS_S3_DESTRUCTIVE_POLICY：confirm は、クライアントが対応している場合は elicitation を使用します。対応していない場合は、人間の同意後に confirm:true が必要です。elicit は elicitation を必須とし、confirm:true による回避を認めません。block は常に禁止し、allow はゲートなしで実行します。拒否はあらゆる S3 リクエストに先立ちます。ゲートの対象は、削除、move、署名付き PUT、ポリシー／Object Lock、versioning の suspension、上書きです。

conditional_writes:true の場合、put／copy／move／multipart complete／upload file の各操作では overwrite:false、対象の HEAD、If-None-Match: * を使用します。false の場合、書き込みはデフォルトで拒否されます。overwrite:true には同じゲートが適用されます。

スコープ：MWS_S3_ALLOWED_BUCKETS=backups と MWS_S3_ALLOWED_PREFIXES=backups/daily/。プレフィックスはセグメント境界を考慮します。daily-evil は対象になりません。'..' セグメントは拒否されます。部分的なスコープでは、バケットが ALLOWED_BUCKETS に含まれていても、バケット全体へのアクセスと広範囲なリスト取得は禁止されます。Copy／move では、ソースと対象の両方を検証します。

ファイル用 MCP ツールは os.Root を使用します。FILE_ROOT 内の相対パスのみが許可され、'..'、絶対パス、外部を指すシンボリックリンクは拒否されます。呼び出しごとに stderr に JSON 形式の 1 行が出力されます。MWS_S3_AUDIT_FILE が設定されている場合は、さらに 0600 で書き込みます。シークレットと X-Amz-Signature/Credential/Security-Token はログ／エラー内でマスキングされます。完全な署名付き URL は操作結果としてのみ返されます。S3 キー自体の権限も制限してください。

s3_download_file はデフォルトで、ダウンロードしたファイルを、ダウンロード中に作成されたファイルも含めて、既存のファイルを置き換えずに公開します。置き換えるには overwrite:true を渡してください。破壊的操作ポリシーが適用され、フォームによる確認、または人間の同意後の confirm:true が必要です。

MWS のプールとストレージクラス

プール、エンドポイント、クラスについては互換性表を、各事実、価格、エラーの一次情報源については調査資料を参照してください。デフォルトのプールは ru-central1 です。SigV4 のリージョンは選択したプールと同じです。プロファイルの verified:false は、versitygw での検証ではクラウド API を確認できないことを示します。確認されていない情報には [推定] の印が付いています。プロファイルの価格は請求額の計算に使用するものではありません。

Lifecycle、ACL、バケットのタグ付け、オブジェクトの保持はクラウドでサポートされている場合がありますが、このバージョンでは設定用のツールを提供していません。プロファイルのデータは、S3 API との互換性を示すものです。

よくある質問

この MCP サーバーがサポートする MWS 製品は何ですか？ このプロファイルは MWS Cloud Platform、エンドポイント storage.mwsapis.ru、署名リージョン ru-central1 向けです。似た名前の別製品には、別のプロファイルが必要です。

MWS S3 にはどのキーが必要ですか？ サービスアカウントの HMAC キーの Access key／Secret key を使用します。mws-s3 auth set で入力してください。入手先と作成手順は、MWS の調査資料に記載されています。コマンドの引数にキーを渡さないでください。

MWS の短い署名付き URL が 60 秒を使用するのはなぜですか？ 調査資料では、文書化された範囲として 60～604800 秒が示されています。60 秒以上を使用してください。実際の動作と上限は、実環境での検証がまだ必要です。

MCP サーバーとは何ですか？ エージェントに Model Context Protocol を通じてツールとリソースを提供するプログラムです。ここでは stdio を使用します。

MCP サーバーを Claude Code に接続するにはどうすればよいですか？ auth set でキーを保存してから、project install または表示された user コマンドを使用してください。

エージェントに S3 へのアクセスを許可しても安全ですか？ キー、スコープ、権限レベルを制限し、confirm／block を維持して、破壊的な操作は内容を理解したうえで承認してください。

aws-cli や rclone との違いは何ですか？ バイナリには MCP、ゲート、監査、分析、スキル、CLI がまとめられています。aws-cli／rclone は、引き続き単独の転送／自動化ツールとして利用できます。

どの機能がサポートされていますか？ capabilities と compat を参照してください。ツールはプロファイルに応じて登録されます。このバージョンでは、ライフサイクル、ACL、バケットタグ付け、オブジェクト保持は設定できません。

その他のプロバイダー

共通カタログ：ロシアの S3 向け MCP サーバーと CLI。

プロバイダー	リポジトリ	シナリオ
Selectel	selectel-s3-mcp-ai-cli	プールの選択とバックアップの復元
Yandex Cloud	yandex-s3-mcp-ai-cli	オブジェクトのインベントリとバックアップバージョンの確認
VK Cloud	vkcloud-s3-mcp-ai-cli	Hotbox／Icebox の確認と必要なリージョンへのアクセス
Cloud.ru	cloudru-s3-mcp-ai-cli	Evolution Object Storage へのアクセス診断
Timeweb Cloud	timeweb-s3-mcp-ai-cli	アーカイブの復元とプレフィックスの容量管理
MWS	mws-s3-mcp-ai-cli	HMAC アクセスの確認とアーカイブ用の短い URL
Beget	beget-s3-mcp-ai-cli	既存のバケットからのファイルの表示と復元
Shared Go kit	s3-mcp-ai-cli-kit	共通の MCP、CLI、保護機能、CI

ライセンス

MIT。確認済みの事実と仮定。

Docker でのチェック：bash scripts/go.sh go test -race ./..., bash scripts/conformance.sh, bash scripts/mcp_smoke.sh, bash scripts/mutation_gate.sh, bash scripts/check_docs.sh。Conformance では versitygw v1.8.0 とテストキーを使用します。

共通の MCP／CLI、保護機能、チェックは s3-mcp-ai-cli-kit v0.1.0 が提供します。このリポジトリには、組み込みプロファイル、薄い main、MWS のドキュメントが残ります。