Azure Storage 向けの Azure MCP Server ツール

Azure MCP サーバーを使用すると、作成、取得、一覧表示、アップロードなどのAzure Storageリソースを自然言語プロンプトで管理できます。

Azure Storageは、アプリケーションにクラウドベースの機能を提供するAzure サービスです。 詳細については、Azure Storage のドキュメントを参照してください。

ツール パラメーター: Azure MCP Server ツールは、タスクを完了するために必要なデータのパラメーターを定義します。 これらのパラメーターの一部は、各ツールに固有であり、ここに記載されています。 その他のパラメーターはグローバルであり、すべてのツールで共有されます。 詳細については、「 ツールパラメーター」を参照してください。

アカウントを作成する

このモデル コンテキスト プロトコル (MCP) ツールは、指定したリソース グループと場所にAzure Storage アカウントを作成し、ストレージ アカウントの名前、場所、SKU、アクセス層、アクセス設定、構成の詳細を返します。

プロンプトの例を次に示します。

  • "リソース グループ 'rg-prod' 内の場所 'eastus' に 'testaccount123' という名前の新しいストレージ アカウントを作成します。"
  • "SKU 'Premium_LRS' を使用して、リソース グループ 'rg-production' 内の場所 'westus2' に 'premiumacct01' という名前のストレージ アカウントを作成します。"
  • "階層型名前空間が有効になっているリソース グループ 'rg-datalake' の下の場所 'eastus2' に 'datalakeacct' という名前の新しいストレージ アカウントを作成します。"
パラメーター 必須または省略可能 Description
アカウント名 必須 作成する Azure Storage アカウントの名前。 グローバルに一意の 3 ~ 24 文字で、小文字と数字のみを使用する必要があります。
場所 必須 ストレージ アカウントが作成されるAzureリージョン (eastuswestus2など)。
リソース グループ 必須 Azure リソース グループの名前。 リソース グループは、Azure リソースの論理コンテナーです。
アクセス層 オプション BLOB ストレージの既定のアクセス層。 有効な値: HotCool
階層型名前空間を有効にする オプション ストレージ アカウントでData Lake Storage Gen2の階層型名前空間を有効にするかどうかを指定します。
学ぶ オプション Azure操作を実行せずに、使用可能なツールとそのパラメーターを検出します。 azmcp ストレージなどのツール グループで使用し、そのグループ内のすべてのツールを一覧表示したり、特定のツール (azmcp ストレージ アカウントの一覧など) でオプションを表示したりします。
SKU オプション ストレージ アカウントの SKU。 有効な値: Standard_LRSStandard_GRSStandard_RAGRSStandard_ZRSPremium_LRSPremium_ZRSStandard_GZRSStandard_RAGZRS

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

BLOB コンテナーを作成する

このツールは、モデル コンテキスト プロトコル (MCP) ツールの一部で、ストレージ アカウントに新しいAzure Storage BLOB コンテナーを作成します。 このツールは、Azure Storage アカウントで BLOB を整理するための論理コンテナーを作成します。

必須: アカウント、コンテナー、サブスクリプション。 省略可: テナント。

戻り値: コンテナー名、lastModified、eTag、leaseStatus、publicAccessLevel、hasImmutabilityPolicy、hasLegalHold。 ストレージ アカウント内で BLOB を整理するための論理コンテナーを作成します。

プロンプトの例を次に示します。

  • "ストレージ アカウント 'mystorageaccount' にストレージ コンテナー 'mycontainer' を作成します。"
パラメーター 必須または省略可能 Description
アカウント名 必須 Azure Storage アカウントの名前。 これは、ストレージ アカウントに対して選択した一意の名前です (たとえば、 mystorageaccount)。
コンテナー名 必須 ストレージ アカウント内でアクセスするコンテナーの名前。
学ぶ オプション Azure操作を実行せずに、使用可能なサブコマンドとそのパラメーターを検出します。 コマンド グループ ( 'azmcp storage --learn' など) で、そのグループ内のすべてのコマンドを一覧表示したり、特定のコマンド ( 'azmcp storage account list --learn' など) でオプションを表示したりします。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

アカウントを取得する

アカウント名、場所、SKU、種類、階層型名前空間の状態、HTTPS 専用設定、BLOB パブリック アクセス構成など、Azure Storage アカウントに関する詳細情報を取得します。 このツールは、モデル コンテキスト プロトコル (MCP) ツールの一部です。 アカウント名を指定しない場合、ツールはサブスクリプション内のすべてのストレージ アカウントの詳細を返します。

プロンプトの例を次に示します。

  • "ストレージ アカウント 'mystorageaccount' の詳細を表示します。"
  • "場所と SKU を含むストレージ アカウント 'companydata2024' のプロパティを取得します。"
  • "場所と SKU を使用して、サブスクリプション内のすべてのストレージ アカウントを一覧表示します。"
  • "サブスクリプションのストレージ アカウントを表示し、階層型名前空間 (HNS) が有効になっているかどうかを示します。"
  • "HTTPS 専用とパブリック BLOB アクセス設定を使用して、サブスクリプション内のストレージ アカウントを表示します。"
パラメーター 必須または省略可能 Description
アカウント名 オプション Azure Storage アカウントの名前 (例: mystorageaccount)。
学ぶ オプション Azure操作を実行せずに、使用可能なサブツールとそのパラメーターを検出します。 ツール グループ ("azmcp storage --learn" など) で使用し、そのグループ内のすべてのツールを一覧表示したり、特定のツール ("azmcp ストレージ アカウントリスト --learn" など) でオプションを表示したりします。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

BLOB を取得する

コンテナー内の BLOB を一覧表示するか、Azure Storage アカウント内の特定の BLOB のプロパティを取得します。 モデル コンテキスト プロトコル (MCP) ツールは、BLOB の一覧または 1 つの BLOB の詳細を返します。 BLOB 名を指定すると、このツールはその BLOB の詳細を返します。 BLOB を指定しない場合、このツールはコンテナー内のすべての BLOB を一覧表示し、プレフィックスで一覧をフィルター処理できます。 BLOB を指定すると、プレフィックスは無視されます。

BLOB 名、サイズ、lastModified、contentType、contentHash、メタデータ、BLOB のプロパティを返します。

プロンプトの例を次に示します。

  • "ストレージ アカウント 'mystorageaccount' のコンテナー 'logs' の BLOB 'logs/2026-01-01.log' のプロパティを表示します。"
  • "ストレージ アカウント 'companydata2024' のコンテナー 'documents' 内の BLOB 'folder/file.txt' に関する詳細を取得します。"
  • "ストレージ アカウント 'backupstorage' の BLOB コンテナー 'backups' 内のすべての BLOB を一覧表示します。"
  • "ストレージ アカウント 'mediaacct' の BLOB コンテナー 'images' の BLOB を表示してください。"
パラメーター 必須または省略可能 Description
アカウント名 必須 Azure Storage アカウントの名前。 これは、ストレージ アカウントに対して選択した一意の名前です (たとえば、 mystorageaccount)。
コンテナー名 必須 ストレージ アカウント内でアクセスするコンテナーの名前。
BLOB 名 オプション コンテナー内でアクセスする BLOB の名前。 これはコンテナー内の完全なパスである必要があります (たとえば、 file.txt または folder/file.txt)。
学ぶ オプション Azure操作を実行せずに、使用可能なツールとそのパラメーターを検出します。 --learnは、ツール グループ (azmcp storage --learn など) で使用し、そのグループ内のすべてのツールを一覧表示したり、特定のツール (azmcp storage account list --learn など) でオプションを表示したりするために使用します。
プレフィックス オプション 指定したプレフィックスで始まる名前を持つ BLOB をフィルター処理します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

Blob コンテナーを取得する

このツールは、モデル コンテキスト プロトコル (MCP) ツールの一部であり、Azure Storage アカウント内の BLOB コンテナーを一覧表示します。 すべてのコンテナーを一覧表示したり、特定のコンテナーの詳細を表示したりできます。 コンテナーを指定しない場合、ツールはすべてのコンテナーを一覧表示し、プレフィックスで結果をフィルター処理できます。 コンテナーを指定すると、プレフィックスは無視されます。 必須: アカウントとサブスクリプション。 省略可能: コンテナー、テナント、プレフィックス。 コンテナー名、lastModified、leaseStatus、publicAccess、メタデータ、およびコンテナー のプロパティを返します。

プロンプトの例を次に示します。

  • "ストレージ アカウント 'mystorageacct' のコンテナー 'logs' のプロパティを表示します。"
  • "ストレージ アカウント 'companydata2024' 内のすべての BLOB コンテナーを一覧表示します。"
  • "ストレージ アカウント 'prodstorage' に含まれるコンテナーは何ですか?
パラメーター 必須または省略可能 Description
アカウント名 必須 Azure Storage アカウントの名前。 これは、ストレージ アカウントに対して選択した一意の名前です ( mystorageaccountなど)。
コンテナー名 オプション ストレージ アカウント内でアクセスするコンテナーの名前。
学ぶ オプション Azure操作を実行せずに、使用可能なサブコマンドとそのパラメーターを検出します。 コマンド グループ ( 'azmcp storage --learn' など) で、そのグループ内のすべてのコマンドを一覧表示したり、特定のコマンド ( 'azmcp storage account list --learn' など) でオプションを表示したりします。
プレフィックス オプション ストレージ アカウント内のコンテナーを一覧表示するときにコンテナーをフィルター処理するプレフィックス。 指定したプレフィックスで始まる名前を持つコンテナーのみが一覧表示されます。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

テーブルを取得する

モデル コンテキスト プロトコル (MCP) の一部であるこのツールは、Azure Storage アカウント内のすべてのテーブルを一覧表示し、その名前を返します。 ストレージ アカウントとサブスクリプション、および必要に応じてテナントを指定します。

プロンプトの例を次に示します。

  • "ストレージ アカウント 'mystorageaccount' 内のすべてのテーブルを一覧表示します。"
  • "ストレージ アカウント 'companydata2024' のテーブルを表示してください。"
パラメーター 必須または省略可能 Description
アカウント名 必須 Azure Storage アカウントの名前。 これは、ストレージ アカウントに対して選択した一意の名前です (たとえば、 mystorageaccount)。
学ぶ オプション Azure操作を実行せずに、使用可能なツールとそのパラメーターを検出します。 ツール グループ ("azmcp storage --learn" など) で使用して、そのグループ内のすべてのツールを一覧表示します。 特定のツール ("azmcp ストレージ アカウント リスト --learn" など) で使用して、そのオプションを表示します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須

BLOB のアップロード

このツールを使用して、BLOB がまだ存在しない場合にのみ、Azure Storage BLOB にローカル ファイルをアップロードします。 このツールは、BLOB の最終変更時刻、ETag、およびコンテンツ ハッシュを返します。

プロンプトの例を次に示します。

  • "アカウント 'mystorageaccount' のコンテナー 'backups' のストレージ BLOB 'documents/report.pdf' にローカル ファイル パス '/home/alice/report.pdf' をアップロードします。"
パラメーター 必須または省略可能 Description
アカウント名 必須 Azure Storage アカウント名 (例: mystorageaccount)。
BLOB 名 必須 file.txtfolder/file.txtなど、任意のパスを含む、コンテナー内の BLOB の名前。
コンテナー名 必須 ストレージ アカウント内のコンテナーの名前。
ローカル ファイル パス 必須 アップロードするローカル ファイルへの完全パス。
学ぶ オプション Azure操作を実行せずに、使用可能なサブツールとそのパラメーターを表示します。

ツール注釈ヒント:

破壊的な 冪等性 オープン ワールド [読み取り専用] Secret ローカル必須