Azure Deploy 用の Azure MCP Server ツール

Azure MCP サーバーは、Azure デプロイ タスクの管理に役立ちます。 これらのタスクには、アーキテクチャ図の生成、アプリ ログの取得、デプロイ 計画の取得、IaC ルールのフェッチ、パイプライン ガイダンスの提供などの操作が含まれます。これらはすべて自然言語プロンプトを通じて行われます。

Azure Deploy は、Azure リソースへのデプロイの計画、検証、監視に役立つ一連のツールです。 詳細については、 Azure Deploy のドキュメントを参照してください

Note

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

アプリ ログを取得する

このツールには、Azure Developer CLI (azd) によってデプロイされるアプリケーションのアプリケーション ログが表示されます。 このツールは、Azure Container Apps、Azure App Service、および Azure Functions について、アプリケーションの Log Analytics ワークスペースに対してクエリを実行します。 azd 環境構成からワークスペースと関連付けられているリソースが自動的に検出されます。 これは、 azd upによってデプロイされたアプリケーションに対してのみ機能します。

デプロイの状態を確認するか、デプロイ後の問題のトラブルシューティングを行います。

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

  • "Azd env name 'dev' とワークスペース フォルダー '/home/alice/projects/my-app' に azd によってデプロイされたアプリケーションのログを表示します。"
パラメーター 必須または省略可能 Description
AZD env name 必須 Azure Developer CLI (azd) によって作成され、 azd init または azd up中にAZURE_ENV_NAMEに格納される環境名。 コンテキストで指定されていない場合、このツールはワークスペース内の .azure ディレクトリをチェックするか、 azd env list実行します。
ワークスペース フォルダー 必須 azd プロジェクトを含むワークスペース フォルダーへの完全なパス。
制限 オプション 取得するログ行の最大数。 結果を制限したり、トークンの制限を超えないようにしたりするために使用します。 既定値は 200 です。

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌

アーキテクチャダイアグラムを生成する

このツールは、モデル コンテキスト プロトコル (MCP) ツールセットの一部です。 推奨される Azure サービスとアプリケーションの論理接続を示す Azure サービス アーキテクチャ図が生成されます。 このツールは、入力として提供されるアプリケーション トポロジ (AppTopology) からダイアグラムをレンダリングします。 サービス、コンピューティング ホスト、依存関係、および環境設定について説明する AppTopology を提供します。 AppTopology を構築するには、ワークスペースをスキャンして、接続文字列のサービス、フレームワーク、環境変数を検出します。 .NET アスパイア アプリケーションの場合は、 aspireManifest.jsonを含めます。 この図では、サービスの選択と接続に焦点を当てています。 詳細なネットワーク トポロジやセキュリティ設計は表示されません。

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

  • "このアプリケーションの未加工の MCP ツール入力 '<secure-password>' の Azure アーキテクチャ図を生成します。"
パラメーター 必須または省略可能 Description
未加工の mcp ツール入力 必須 このツールの入力構造を定義する JSON オブジェクト。

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌

IaC ルールを取得する

Bicep と Terraform Infrastructure as Code (IaC) ファイルを作成して Azure アプリケーションをデプロイするための規則とベスト プラクティスを取得します。 このモデル コンテキスト プロトコル (MCP) ツールは、Azure リソース構成標準、Azure Developer CLI (azd) と Azure CLI との互換性、および一般的な IaC 品質要件に関するガイダンスを返します。 このガイダンスを使用して、Azure リソース用の Bicep スクリプトと Terraform テンプレートを改善し、Azure のベスト プラクティスに合わせてデプロイを調整します。

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

  • "デプロイ ツール 'AzCli' を使用して Bicep と Terraform IaC for Azure を記述するための規則とベスト プラクティスについて説明します。"
パラメーター 必須または省略可能 Description
デプロイ ツール 必須 使用するデプロイ ツール。 有効な値: AzCliAZD
IaC 型 オプション デプロイに使用される IaC ファイルの種類。 有効な値には、 bicepterraformが含まれます。 IaC ファイルなしで Azure CLI コマンド スクリプトを使用する場合にのみ、空のままにします。
リソースの種類 オプション ルールを生成する Azure リソースの種類の一覧。 コンテキストから値を取得し、プランで定義されているのと同じリソースを使用します。 有効な値: appservicecontainerappfunctionaksazuredatabaseforpostgresqlazuredatabaseformysqlazuresqldatabaseazurecosmosdbazurestorageaccountazurekeyvault

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌

例示

  • Azure App Service と Azure SQL Database 用の Bicep および Terraform の IaC 規則を提供します。デプロイ ツール 'AZD' および IaC タイプ 'bicep' に対する 'appservice' および 'azuresqldatabase' リソースの規則を取得します。
  • Azure Kubernetes Service と Azure Key Vault をデプロイする Terraform テンプレートのベスト プラクティスを示します。"リソース 'aks'、'azurekeyvault' のデプロイ ツール 'AzCli' と IaC 型 'terraform' の規則を取得します。
  • AzCli スクリプトを使用して、IaC ファイルなしで一般的な IaC 品質チェックを要求します。"デプロイ ツール 'AzCli' のルールを取得し、リソース 'azurestorageaccount' の IaC の種類を空のままにします。"

パイプラインのガイダンスを取得する

このモデル コンテキスト プロトコル (MCP) ツールは、GITHub Actions または Azure DevOps パイプラインを使用してアプリケーションを Azure にデプロイするための CI/CD パイプライン構成とステップ バイ ステップ ガイダンスを生成します。 Azure Developer CLI (azd) と Azure CLI ベースのデプロイがサポートされています。 インフラストラクチャをプロビジョニングし、アプリケーション コードをデプロイするパイプラインを生成できます。

GitHub Actions または Azure DevOps を選択し、パイプラインでインフラストラクチャのみをデプロイするかプロビジョニングするかを決定し、プロジェクトで azd を使用するかどうかを確認できます (たとえば、 azure.yaml ファイルが存在します)。 deploy-onlyまたはprovision-and-deployを指定し、プロジェクトで azd ツールを使用し、azure.yaml ファイルが使用可能な場合にのみ、Is azd projecttrueに設定します。

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

  • GitHub Actions を使って、AZD プロジェクトではなく、デプロイ オプション "deploy-only" の条件で、パイプライン プラットフォーム “github-actions” により、アプリを Azure にデプロイするための CI/CD パイプラインを設定するにはどうすればよいですか?
パラメーター 必須または省略可能 Description
デプロイ オプション 必須 有効な値: deploy-only、provision-and-deploy。 既定値はデプロイ目的のみです。 ローカル プロビジョニング スクリプトを使用するインフラストラクチャ プロビジョニング パイプラインが明示的に必要な場合にのみ、 provision-and-deploy に設定します。
AZD プロジェクトですか 必須 デプロイ パイプラインで AZD ツールを使用するかどうか。 trueに設定されるのは、azure.yamlが提供されている場合、またはコンテキストが AZD ツールを提案する場合のみです。
パイプライン プラットフォーム 必須 デプロイ パイプラインのプラットフォーム。 有効な値: github-actionsazure-devops

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌

デプロイ計画を取得する

Azure へのアプリケーションの書式設定された段階的なデプロイ計画を生成します。 モデル コンテキスト プロトコル (MCP) の一部であるこのツールは、Azure リソースを提案し、コードとしてのインフラストラクチャ (IaC) テンプレートを提供し、ターゲット ホスティング サービスと選択したプロビジョニング ツールに基づくデプロイ手順を一覧表示します。 たとえば、ターゲット ホスティング サービスには、Azure Container Apps、Azure App Service、または Azure Kubernetes Service (AKS) が含まれます。 プロビジョニング ツールの例としては、Azure Developer CLI (azd)、Bicep を使用した Azure CLI、Terraform などがあります。

このツールでは、ワークスペースがスキャンされたり、リソースが自動的に検出されたりすることはありません。 プロジェクトを分析し、フレームワーク、依存関係、および既存のリソースを決定し、ホスティング サービスとプロビジョニング ツールを選択し、それらの値を指定してプランを生成します。

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

  • "デプロイ オプション 'provision-and-deploy'、プロビジョニング ツール 'AZD'、ソースの種類 'from-project'、ターゲット アプリ サービス 'WebApp'、ワークスペース フォルダー '/home/dev/my-webapp'、および IaC オプション 'bicep' を使用して、プロジェクト名 'my-webapp' の Azure への段階的なデプロイ計画を作成するにはどうすればよいですか?
パラメーター 必須または省略可能 Description
デプロイ オプション 必須 プロジェクトとユーザーの入力に基づいて値を設定します。 有効な値: provision-and-deploydeploy-onlyprovision-only。 既存の Azure リソースにデプロイするとき、または IaC ファイルが既に存在する場合は、 deploy-only を選択します。 Azure リソースのみをプロビジョニングする場合は、 provision-only を選択します。 インフラストラクチャをプロビジョニングしてアプリケーションをデプロイする場合は、 provision-and-deploy を選択します。
プロジェクト名 必須 配置計画を生成するプロジェクトの名前。 プロジェクト名を指定しない場合、ツールによってワークスペースから推測されます。
プロビジョニング ツール 必須 Azure リソースのプロビジョニングに使用するツール。 有効な値: AzCliAZD。 たとえば、Azure Developer CLI (azd) や Bicep を使用した Azure CLI などです。
ソースの種類 必須 生成するためのプランの出所。 有効な値: from-projectfrom-azurefrom-contextfrom-projectを使用して、ワークスペース内のプロジェクト ファイルに基づいてプランを作成します。 from-azureを使用して、既存の Azure リソースに基づいてプランを作成します。 from-contextを使用して、プロジェクト ファイルや Azure リソースが存在しない場合に指定した値に基づいてプランを作成します。
ターゲット アプリ サービス 必須 アプリケーションをデプロイする Azure サービス。 有効な値: ContainerAppWebAppFunctionAppAKS。 アプリケーションのアーキテクチャとランタイムに基づいて推奨されます。
ワークスペース フォルダー 必須 ワークスペース フォルダーの完全なパス。
IaC オプション オプション [コードとしてのインフラストラクチャ] オプション。 有効な値: bicepterraform。 Azure CLI スクリプトを使用するには、空のままにします。
リソース グループ オプション Azure リソース グループの名前。

ツール注釈ヒント:

破壊的: ❌ | 冪等: ✅ | オープンワールド: ❌ | 読み取り専用: ✅ | シークレット: ❌ | ローカル必須: ❌