Azure Advisor 向けの Azure MCP Server ツール

Azure MCP Server は、推奨事項の適用、詳細の取得、推奨事項の一覧表示、自然言語プロンプトによる概要の提供など、Azure Advisorリソースの管理に役立ちます。

Azure Advisorは、Azure リソースを分析し、コスト、パフォーマンス、信頼性、セキュリティを最適化するために、パーソナライズされた実用的な推奨事項を提供します。 詳細については、Azure Advisorドキュメントを参照してください。

注

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

メタデータ: 取得

特定Azure Advisor推奨事項の種類のメタデータを取得します。 推奨事項の種類の表示名、カテゴリ、サブカテゴリ、影響、サポートされているリソースの種類、説明、潜在的な利点、修復アクションを返します。 メタデータを使用して推奨事項を理解し、その影響を評価し、修復手順を計画します。

CLI コマンドの例

azmcp advisor metadata get \
  --recommendation-type-id <recommendation-type-id> \
  [--language <language>]
パラメーター タイプ 必須 説明
recommendation-type-id 文字列 はい グローバルな推奨事項メタデータ カタログで参照するための、安定した Advisor 推奨事項タイプ ID (properties.recommendationTypeId)。 この ID は、個々の推奨事項と共有される結合キーです。
language 文字列 いいえ 絞り込みに使用するカタログロケール (properties.language)。 既定値は en です。 大文字と小文字を区別しません。 サポートされる値: en、 cs、 de、 es、 fr、 hu、 id、 itja、 ko、 nl、 pl、 pt-br、 pt-pt、 ru、 sv、 tr、 zh-hans、 zh-hant。 Advisor は、 en-US などの地域修飾タグを受け入れ、基本言語 (en) にマップします。

ツール注釈ヒント:

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

メタデータ: リスト

推奨事項Azure Advisorメタデータ (推奨事項の種類とも呼ばれます) を一覧表示します。 アクティブな推奨事項が存在しない場合でも、仮想マシンなどのリソースをデプロイする前に、Azure Advisor でどのような推奨事項を生成できるかを把握するのに役立ちます。 指定した提供終了日の前後に発生した Advisor サービスの提供終了を示し、サービス正常性追跡 ID でサービス提供終了メタデータを検索します。 グローバル Azure Resource Graph カタログを使用したグリーンフィールド検出と、ブラウンフィールド オンボーディングのためのリソースの種類のフィルター処理をサポートします。 言語、リソースの種類、影響、カテゴリ、サブカテゴリ、追跡 ID、提供終了日の省略可能なフィルターを受け入れます。 ローカライズされた型 ID、名前、カテゴリ、サブカテゴリ、影響、優先度、説明、利点、アクション、スコープ、ソース クエリ、サービス提供終了の詳細を返します。 結果を影響度の高、中、低の順に並べ替え、その後表示名で並べ替えます。

CLI コマンドの例

azmcp advisor metadata list \
  [--language <language>] \
  [--resource-type <resource-type>] \
  [--impact <impact>] \
  [--category <category>] \
  [--sub-category <sub-category>] \
  [--tracking-id <tracking-id>] \
  [--retirement-date <retirement-date>]
パラメーター タイプ 必須 説明
language 文字列 いいえ ローカライズされた推奨事項メタデータの言語。 既定値は英語 (en)。 サポートされているカタログ言語は、 en、 cs、 de、 es、 fr、 hu、 id、 itja、 ko、 nl、 plpt-BR、 pt-PT、 ru、 sv、 tr、 zh-Hans、および zh-Hantです。 リージョンバリアントは、サポートされている基本言語 (enへのen-USやfrへのfr-CAなど) にマップされます。ロケール固有のカタログ言語は異なります。
resource-type 文字列 いいえ microsoft.compute/virtualmachines などの、省略可能な Azure リソースの種類の完全一致フィルター。 ブラウンフィールドのオンボード時に使用して、そのリソースの種類に適用可能な推奨事項の種類を検出します。 このフィルターは大文字と小文字を区別しません。
impact 文字列 いいえ オプションの推奨事項の影響フィルター。 使用できる値は、 High、 Medium、または Lowです。 フィルターは大文字と小文字を区別しません。 既定では、結果は High、 Medium、 Low 順に表示されます。
category 文字列 いいえ オプションの Advisor カテゴリ完全一致フィルター。 指定できる値は、Cost、HighAvailability、Security、Performance、および OperationalExcellence です。 このフィルターは大文字と小文字を区別しません。
sub-category 文字列 いいえ オプションの、推奨事項のサブカテゴリを厳密に指定するフィルター。 このフィルターは、大文字と小文字を区別しません。 既知のカタログ値には、 ComputeOptimization、 DataPerformance、 DataProtectionAndRecovery、 EfficiencyOptimization、 FailureMitigation、 GovernanceAndCompliance、 MonitoringAndAlerting、 NetworkOptimization、 Other、 Personalized、 RegionalResiliency、 Reservations、 SafeAndSecureDeployment、 SavingsPlanScalability、 ServiceUpgradeAndRetirement、 StorageOptimization、 UsageOptimization、および ZoneResiliencyが含まれます。 カタログは時間の経過と同時に値を追加できるため、ツールは他のサブカテゴリを受け入れます。
tracking-id 文字列 いいえ たとえば QNY1-HB8 のような、Service Health の追跡 ID に対する省略可能な厳密一致フィルター。 フィルターでは大文字と小文字が区別されず、 ServiceUpgradeAndRetirement メタデータ内で適用されます。 --sub-categoryは省略できますが、別の値を指定することはできません。
retirement-date 文字列 いいえ ge:2026-03-31 形式の任意のサービス終了日フィルター。たとえば <operator>:<yyyy-MM-dd>。 サポートされている演算子は、 eq、 lt、 le、 gt、および geです。 ServiceUpgradeAndRetirement サブカテゴリにのみ適用されます。 --sub-categoryは省略できますが、別の値を指定することはできません。

ツール注釈ヒント:

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

推奨事項: 適用

Azure Resource Manager (ARM) テンプレートや Terraform 構成など、Azure Advisorの推奨事項をコードとしてのインフラストラクチャ (IaC) ファイルに適用するのに役立ちます。 IaC ファイルに適用する規則が返されます。

CLI コマンドの例

azmcp advisor recommendation apply \
  --resource <resource>
パラメーター タイプ 必須 説明
resource 文字列 はい IaC ファイルルールを取得するAzureリソースの種類。 利用可能なオプション: aad_domainservices、 apimanagement_service、 cognitiveservices_accounts、 compute_virtualmachines、 compute_virtualmachinescalesets、 containerregistry_registries、 containerservice_managedclusters、 dbforpostgresql_flexibleservers、 documentdb_databaseaccounts、 keyvault_vaults、 kubernetes_connectedclusters、 kubernetesconfiguration_extensions、 netapp_volumes、 network_applicationgatewaywebapplicationfirewallpolicies、 network_expressrouteports、 network_frontdoorwebapplicationfirewallpolicies、 sql_managedinstances、 storage_storageaccounts、 web_serverfarms、 web_staticsites

ツール注釈ヒント:

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

推奨事項: リスト

サブスクリプションの個々のAzure Advisor推奨事項を一覧表示し、推奨事項ごとに 1 つのレコードを返します。 このコマンドは、推奨事項の内容と詳細を表示する場合にのみ使用します。 集計、ランク付け、比較、カウントの質問については、代わりに advisor recommendation summary を使用してください。 状態が New アクティブな推奨事項のみを返し、無視された推奨事項と延期された推奨事項を除外します。 カテゴリ、影響、リソースの種類、リソース、およびフリー テキスト検索の省略可能なフィルターをサポートします。 top パラメーターは、返される項目数の上限を設定します。既定値は 50、最大値は 100 です。 このコマンドは最大 100 個のレコードを返すので、集計計算に結果を使用すると、合計が過小評価される可能性があります。

CLI コマンドの例

azmcp advisor recommendation list \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
パラメーター タイプ 必須 説明
category 文字列 いいえ カテゴリ ( Security、 Cost、 Performance、 HighAvailability、 OperationalExcellenceなど) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
impact 文字列 いいえ ビジネスへの影響 (High、 Medium、または Low) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
resource-type 文字列 いいえ 影響を受けたAzureリソースの種類 (Microsoft.Storage/storageAccounts など) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
resource 文字列 いいえ 影響を受けたリソース名または完全な ARM リソース ID で推奨事項をフィルター処理します。 大文字と小文字を区別しない部分文字列の一致。
search 文字列 いいえ 推奨事項の問題のテキスト (大文字と小文字を区別しない部分文字列の一致) にフリー テキスト フィルターを適用します。 これは、要求に related to Microsoft Foundry、 about encryption、 mentioning right-size、 for Key Vaultなどの話題の語句が含まれている場合に使用します。 フレーズ (たとえば、 Foundry、 encrypt、 right-size、 Key Vault) から顕著な名詞を抽出し、ここに渡します。
top 文字列 いいえ 返されるアイテムの最大数。 listの場合:既定値は 50 で、サーバー側の範囲は 1 から 100 です。 summaryの場合: 返されるバケットの数に対するオプションの表示上限 (既定値は all)。 TotalRecommendations は、 --topに関係なく、フィルター処理された完全な母集団を常に反映します。
resource-group 文字列 いいえ Azure リソース グループ名です。

ツール注釈ヒント:

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

推奨事項: 概要

このコマンドは、アクティブなAzure Advisorの推奨事項を状態Newで集計し、バケットごとの数と正確な合計を返します。 集計、ランク付け、比較、カウントの質問には、このコマンドを使用します。 集計の前にフィルターが適用されます。 結果を recommendation-type、 category、 impact、または resource-typeでグループ化します。 既定のグループ化は categoryであり、コスト、セキュリティ、信頼性などの高レベルのテーマが表示されます。 topパラメーターは表示されるバケット数を制限しますが、TotalRecommendationsは常にフィルター後の母集団全体を反映します。 このコマンドは、 Unknown バケットを最終的な結果として保持します。テーブルにグループを表示するときに、最後の行として含めます。

CLI コマンドの例

azmcp advisor recommendation summary \
  [--group-by <group-by>] \
  [--category <category>] \
  [--impact <impact>] \
  [--resource-type <resource-type>] \
  [--resource <resource>] \
  [--search <search>] \
  [--top <top>] \
  [--resource-group <resource-group>]
パラメーター タイプ 必須 説明
group-by 文字列 いいえ 概要をグループ化するフィールド。 次のいずれか: recommendation-type、 category、 impact、 resource-type。 既定では category が使用され、これにより大まかなテーマ（コスト、セキュリティ、信頼性など）が提示されるため、フィールド名を指定しなくても summarize the key themes from my Advisor recommendations のようなプロンプトが機能します。
category 文字列 いいえ カテゴリ ( Security、 Cost、 Performance、 HighAvailability、 OperationalExcellenceなど) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
impact 文字列 いいえ ビジネスへの影響 (High、 Medium、または Low) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
resource-type 文字列 いいえ 影響を受けたAzureリソースの種類 (Microsoft.Storage/storageAccounts など) で推奨事項をフィルター処理します。 大文字と小文字を区別しない完全一致。
resource 文字列 いいえ 影響を受けたリソース名または完全な ARM リソース ID で推奨事項をフィルター処理します。 大文字と小文字を区別しない部分文字列の一致。
search 文字列 いいえ 推奨事項の問題のテキスト (大文字と小文字を区別しない部分文字列の一致) に適用されるフリー テキスト フィルター。 要求に related to Microsoft Foundry、 about encryption、 mentioning right-size、 for Key Vaultなどの話題の語句が含まれる場合は常に、このフィルターを使用します。 フレーズ (たとえば、 Foundry、 encrypt、 right-size、 Key Vault) から顕著な名詞を抽出し、ここに渡します。
top 文字列 いいえ 返されるアイテムの最大数。 listの場合:既定値は 50、クランプは 1 から 100 (サーバー側の制限) です。 summaryの場合: 返されるバケットの数に対するオプションの表示上限 (既定値は all)。 TotalRecommendations は、 --topに関係なく、フィルター処理された完全な母集団を常に反映します。
resource-group 文字列 いいえ Azure リソース グループ名です。

ツール注釈ヒント:

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

関連するコンテンツ

  • Last updated on