Azure Files

Azure Files共有に保存されたファイルとディレクトリを参照し、必要なファイルを読み取るか、ファイルストレージに取り込むことができます。必要に応じて、Azure Files共有に新しいディレクトリを作成したり、作業中に生成したファイルをAzure Filesへアップロードしたりできます。

主な機能

Microsoft OAuth認証を使用します。

このMCPはAzure Filesクラウドストレージにアクセスします。ユーザーのローカルファイルシステムを参照または読み取る用途では使用しません。

設定されたAzure Storageアカウントでアクセス可能なAzure Files共有一覧を照会します。ユーザーが共有名を指定していない場合に最初に使用します。

指定した共有とディレクトリパス配下のファイルおよびサブディレクトリを照会します。結果には名前、パス、タイプ、サイズ情報が含まれる場合があります。

ファイルまたはディレクトリのメタデータを照会します。ファイル内容を読み取る、またはダウンロードする前にサイズとコンテンツタイプを確認する場合に使用します。

Azure Filesに保存されたテキストファイル内容をチャット応答内で直接読み取ります。バイナリファイルや大容量ファイルは download_file を使用します。

Azure Filesのファイルをファイルストレージにダウンロードし、aip-temp:// または aip-drive:// URIを返します。PDF、Officeドキュメント、画像、バイナリファイルのようにチャットに直接表示しにくいファイルに使用します。

ファイル名またはパスに含まれる文字列を基準にAzure Filesを検索します。本文全体検索はサポートしていません。検索範囲が広すぎる場合は、パスや検索語を絞り込んで再度実行することを推奨します。

指定した共有の既存親ディレクトリ配下に新しいディレクトリを作成します。一度に作成できるのは1階層のみです。親ディレクトリが存在しない場合は、先に作成先を確認する必要があります。対象ディレクトリが既に存在する場合は、新規作成せず既存ディレクトリとして扱います。

チャット、スキル、他のMCPツールなどで生成または取得したAIPファイルURIを、Azure Files共有の既存ディレクトリに新しいファイルとしてアップロードします。対象ファイル名が既に存在する場合、アップロードは失敗します。既存ファイルの上書きやファイル名の自動変更は行いません。

Azure StorageアカウントとAzure Files共有にアクセスできるMicrosoftアカウント権限が必要です。
read_file はテキスト形式ファイルに適しています。PDF、Officeドキュメント、画像、大容量ファイルはダウンロード後に別のツールまたはスキルと一緒に処理してください。
search_files はファイル名とパス基準の検索であり、ファイル本文内容は検索しません。
create_directory は複数階層のフォルダーを一度に作成しません。必要に応じて親ディレクトリから順番に作成してください。
upload_file はAzure Filesの既存ディレクトリに新しいファイルを保存する機能です。対象ディレクトリは自動作成されず、既存ファイルは上書きされません。
upload_file は現在、SMB Azure Files共有のみサポートします。NFS共有にはアップロードできません。