Azure の Microsoft Foundry 拡張機能用 MCP Server ツール

Azure MCP サーバーを使用すると、自然言語プロンプトを使用して、Microsoft Foundry Extensions リソースを管理できます。これには、チャットとテキスト入力候補の作成、埋め込みの生成、モデルの一覧表示、ナレッジ インデックスの操作が含まれます。

Microsoft Foundry は、Azureでカスタム AI モデルをデプロイおよび管理するためのプラットフォームです。 運用環境での AI モデルのトレーニング、微調整、デプロイ、監視のためのツールとサービスを提供します。

ナレッジ インデックス コマンドには、Microsoft Foundry プロジェクトのエンドポイントが必要です。 OpenAI コマンドには、リソース名とリソース グループが必要です。 resource get コマンドでは、リソース名を指定せずにリソースを一覧表示できます。

Note

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

ナレッジ: ナレッジ インデックスを一覧表示する

Foundry からナレッジ インデックスの一覧を取得します。

  • Foundry プロジェクト内で作成されたナレッジ インデックスを検索します。
  • 知識の取得と RAG アプリケーションには、これらのインデックスを AI エージェントと共に使用します。
  • 新しいインデックスを作成したり、既存のインデックスを更新したりすると、リストが更新されます。

CLI コマンドの例

azmcp foundryextensions knowledge index list \
  --endpoint <endpoint>
Parameter タイプ Required Description
endpoint 文字列 はい Microsoft Foundry プロジェクトまたはサービスのエンドポイント URL。 エンドポイントは、 https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>というパターンに従います。

ツール注釈ヒント:

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

ナレッジ: インデックス スキーマを取得する

Foundry から特定のナレッジ インデックスの詳細なスキーマ構成を取得します。

この操作では、フィールド定義、データ型、検索可能な属性、その他のスキーマ プロパティなど、ナレッジ インデックスの構造と構成に関する包括的な情報が表示されます。 このスキーマ情報を使用して、検索のためにデータのインデックス構造とインデックスを作成する方法を理解します。

CLI コマンドの例

azmcp foundryextensions knowledge index schema \
  --index <index> \
  --endpoint <endpoint>
Parameter タイプ Required Description
index 文字列 はい ナレッジ インデックスの名前。
endpoint 文字列 はい Microsoft Foundry プロジェクトまたはサービスのエンドポイント URL。 エンドポイントは、 https://<foundry-resource-name>.services.ai.azure.com/api/projects/<project-name>というパターンに従います。

ツール注釈ヒント:

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

OpenAI: チャットの回答を生成する

Foundry で Azure OpenAI を使用してチャット補完を作成する。 Foundry リソースにデプロイAzure OpenAI チャット モデルにメッセージを送信し、AI によって生成された会話応答を受信します。 メッセージ履歴、システム命令、応答のカスタマイズを使用した複数ターンの会話をサポートします。

CLI コマンドの例

azmcp foundryextensions openai chat-completions-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --message-array <message-array> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>] \
  [--top-p <top-p>] \
  [--frequency-penalty <frequency-penalty>] \
  [--presence-penalty <presence-penalty>] \
  [--stop <stop>] \
  [--stream <stream>] \
  [--seed <seed>] \
  [--user <user>]
Parameter タイプ Required Description
resource-name 文字列 はい Microsoft Foundry リソースの名前。
deployment 文字列 はい デプロイの名前。
message-array 文字列 はい 会話内のメッセージの JSON 配列。 各メッセージには、 role プロパティと content プロパティが必要です。
resource-group 文字列 はい Azure リソース グループ名です。
max-tokens 文字列 不要 完了時に生成するトークンの最大数。
temperature 文字列 不要 出力のランダム性を制御します。 値を小さくすると、より決定的になります。
top-p 文字列 不要 核サンプリング (0.0 ~ 1.0) を使用して多様性を制御します。 既定値は 1.0 です。
frequency-penalty 文字列 不要 頻度が (-2.0, 2.0) の場合、新しいトークンにペナルティを与えます。 既定値は 0 です。
presence-penalty 文字列 不要 存在度に応じて (-2.0 から 2.0)、新しいトークンに減点します。 既定値は 0 です。
stop 文字列 不要 API がさらにトークンの生成を停止する最大 4 つのシーケンス。
stream 文字列 不要 部分的な進行状況をストリーム バックするかどうか。 既定値は falseです。
seed 文字列 不要 指定した場合、システムは決定論的にサンプリングするためのベスト エフォートを行います。
user 文字列 不要 追跡と不正使用の監視用のユーザー識別子。

ツール注釈ヒント:

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

OpenAI: 埋め込みを作成する

Foundry Azure OpenAI を使用して埋め込みを作成します。 セマンティック検索、類似性の比較、クラスタリング、機械学習のために Foundry リソースの Azure OpenAI デプロイを使用して、テキストからベクター埋め込みを生成します。

CLI コマンドの例

azmcp foundryextensions openai embeddings-create \
  --resource-name <resource-name> \
  --deployment <deployment> \
  --input-text <input-text> \
  --resource-group <resource-group> \
  [--user <user>] \
  [--encoding-format <encoding-format>] \
  [--dimensions <dimensions>]
Parameter タイプ Required Description
resource-name 文字列 はい Microsoft Foundry リソースの名前。
deployment 文字列 はい デプロイの名前。
input-text 文字列 はい 埋め込みを生成するためのテキスト入力。
resource-group 文字列 はい Azure リソース グループ名です。
user 文字列 不要 追跡と不正使用の監視用のユーザー識別子。
encoding-format 文字列 不要 埋め込みを返す形式 (float または base64)。
dimensions 文字列 不要 埋め込み出力のディメンションの数。 一部のモデルでのみサポートされます。

ツール注釈ヒント:

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

OpenAI: 入力補完を作成する

Foundry Azure OpenAI を使用してテキスト補完を作成します。 Foundry リソースにデプロイされた OpenAI モデルAzureにプロンプトまたは質問を送信し、生成されたテキスト回答を受け取ります。 補完を作成する必要がある場合、AI が生成したコンテンツを取得する場合、質問への回答を生成する場合、または任意の入力プロンプトに基づいて Azure OpenAI からテキスト補完を生成する場合は、この機能を使用します。 温度トークンと最大トークンを使用したカスタマイズをサポートします。

CLI コマンドの例

azmcp foundryextensions openai create-completion \
  --deployment <deployment> \
  --prompt-text <prompt-text> \
  --resource-name <resource-name> \
  --resource-group <resource-group> \
  [--max-tokens <max-tokens>] \
  [--temperature <temperature>]
Parameter タイプ Required Description
deployment 文字列 はい デプロイの名前。
prompt-text 文字列 はい 完了モデルに送信するプロンプト テキスト。
resource-name 文字列 はい Microsoft Foundry リソースの名前。
resource-group 文字列 はい Azure リソース グループ名です。
max-tokens 文字列 不要 完了時に生成するトークンの最大数。
temperature 文字列 不要 出力のランダム性を制御します。 値を小さくすると、より決定的になります。

ツール注釈ヒント:

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

OpenAI: モデルとデプロイを一覧表示する

Microsoft Foundry リソースAzure OpenAI モデルのデプロイを一覧表示します。 このツールは、モデル名、バージョン、機能、デプロイ状態など、デプロイされたモデルに関する情報を取得します。

CLI コマンドの例

azmcp foundryextensions openai models-list \
  --resource-name <resource-name> \
  --resource-group <resource-group>
Parameter タイプ Required Description
resource-name 文字列 はい Microsoft Foundry リソースの名前。
resource-group 文字列 はい Azure リソース グループ名です。

ツール注釈ヒント:

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

リソース: Foundry リソースを取得する

Microsoft Foundry リソースを一覧表示または取得し、エンドポイント URL、場所、SKU、種類、プロビジョニング状態などのリソース レベルの詳細情報を返します。 リソース名を指定すると、ツールはその 1 つのリソースを返します。 それ以外の場合は、スコープ内のリソース インベントリが返されます。 Foundry リソース内のモデル デプロイ インベントリの場合は、OpenAI モデル リスト ツールを使用します。

CLI コマンドの例

azmcp foundryextensions resource get \
  [--resource-name <resource-name>]
Parameter タイプ Required Description
resource-name 文字列 不要 Microsoft Foundry リソースの名前。

ツール注釈ヒント:

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

関連コンテンツ

  • Last updated on