Azure MCP 伺服器幫助你管理 Azure 部署任務。 這些任務包括產生架構圖、取得應用程式日誌、檢索部署計畫、取得 IaC 規則,以及提供流程指引,全部透過自然語言提示。
Azure Deploy 是一組工具,幫助你規劃、驗證及監控 Azure 資源的部署。 欲了解更多資訊,請參閱 Azure Deploy 文件。
注意
工具參數:Azure MCP 伺服器工具會定義完成工作所需資料的參數。 這些參數中有些是針對每種工具而定,並在此處有詳細說明。 其他參數是全局參數,並由所有工具共用。 如需詳細資訊,請參閱 工具參數。
取得應用程式日誌
此工具顯示 Azure Developer CLI(azd)部署的應用程式日誌。 此工具會查詢應用程式的 Log Analytics workspace 中 Azure 容器應用、Azure App 服務 及 Azure 功能。 它會自動從 azd 環境設定中發現工作區及相關資源。 它僅適用於由 部署的 azd up應用程式。
請檢查部署狀態或排除部署後的問題。
範例提示包括:
- 「請給我看 azd 部署的應用程式日誌,該應用程式在 azd 環境名稱 'dev' 和工作區資料夾 '/home/alice/projects/my-app' 中。」
| 參數 | 必要或選用 | Description |
|---|---|---|
| AZD 環境名稱 | 為必填項目 | 由 Azure 開發者 CLI(azd)建立的環境名稱,並在 azd init 或 azd up 期間儲存在 AZURE_ENV_NAME 中。 若未在上下文中提供,此工具會檢查工作區中的 .azure 目錄,或執行 azd env list。 |
| 工作區資料夾 | 為必填項目 | 完整路徑指向包含 azd 專案的工作區資料夾。 |
| 限制 | 可選 | 最多可取回的日誌行數。 利用它來限制結果或避免超過代幣上限。 預設值為 200。 |
| 破壞性 | 冪等 | 開放世界 | 唯讀 | Secret | 本地必修 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ✅ |
產生架構圖
此工具是模型情境協定(MCP)工具組的一部分。 它會產生一個 Azure 服務架構圖,顯示應用程式推薦的 Azure 服務及其邏輯連接。 此工具會根據輸入的應用程式拓撲(AppTopology)來渲染圖表。 你提供一個 AppTopology,描述服務、運算主機、相依關係和環境設定。 你可以透過掃描工作區來建立 AppTopology,以偵測服務、框架和環境變數中的連線字串。 對於 .NET Aspire 應用程式,請包含 aspireManifest.json。 圖中著重於服務選擇與連接。 它沒有顯示詳細的網路拓撲或安全設計。
範例提示包括:
- 「為本應用生成 Azure 架構圖,原始 MCP 工具輸入 '<secure-password>'。」
| 參數 | 必要或選用 | Description |
|---|---|---|
| 原始 mcp 工具輸入 | 為必填項目 | 定義此工具輸入結構的 JSON 物件。 |
| 破壞性 | 冪等 | 開放世界 | 唯讀 | Secret | 本地必修 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
取得 IaC 規則
檢索用於建立 Bicep 與 Terraform 基礎設施即程式碼(IaC)檔案以部署 Azure 應用程式的規則與最佳實務。 此模型情境協定(MCP)工具回傳有關 Azure 資源配置標準、與 Azure Developer CLI(azd)及 Azure CLI 的相容性,以及一般 IaC 品質要求的指引。 利用指引改進 Bicep 腳本與 Terraform 範本,並讓部署與 Azure 最佳實務對齊。
範例提示包括:
- 「請給我看看使用部署工具『AzCli』撰寫 Bicep 和 Terraform IaC for Azure 的規則與最佳實務。」
| 參數 | 必要或選用 | Description |
|---|---|---|
| 部署工具 | 為必填項目 | 要使用的部署工具。 有效值: AzCli、 AZD。 |
| IaC 類型 | 可選 | 部署時使用的 IaC 檔案類型。 有效值包括 bicep、 。 terraform 只有當你想使用 Azure CLI 指令腳本而不使用 IaC 檔案時,才留空。 |
| 資源類型 | 可選 | Azure 資源類型清單,供產生規則。 從情境中取得價值,並使用計畫中定義的相同資源。 有效值:appservice,containerapp,function,aks,azuredatabaseforpostgresql,azuredatabaseformysql。azuresqldatabaseazurecosmosdbazurestorageaccountazurekeyvault |
| 破壞性 | 冪等 | 開放世界 | 唯讀 | Secret | 本地必修 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
範例
- 提供 Azure App 服務 和 Azure SQL Database 的 Bicep 和 Terraform IaC 規則:獲取適用於部署工具 'AZD' 和 IaC 類型 'bicep' 的規則,針對資源 'appservice' 和 'azuresqldatabase'。
- 展示使用 Terraform 範本部署 Azure Kubernetes Service 和 Azure Key Vault 的最佳做法:「取得部署工具『AzCli』和 IaC 類型 'terraform' 的資源 'aks' 和 'azurekeyvault' 的規則」。
- 請求一般 IaC 品質檢查,不需要 IaC 檔案,使用 AzCli 腳本:「取得部署工具 'AzCli' 的規則,並將 IaC 類型留空以適用於 'azurestorageaccount' 資源」。
取得流程指導
此模型情境協定(MCP)工具能產生 CI/CD 管線設定及逐步指引,協助透過 GitHub Actions 或 Azure DevOps 管線部署應用程式至 Azure。 它支援 Azure Developer CLI(azd)及基於 Azure CLI 的部署。 它能產生管道來配置基礎設施並部署應用程式程式碼。
你可以選擇 GitHub Actions 或 Azure DevOps,決定管線是只部署還是同時配置基礎設施,並確認專案是否使用 azd(例如 azure.yaml 有檔案存在)。 指定 deploy-only 或 provision-and-deploy,並僅在專案使用 azd 工具且有 azure.yaml 檔案時設定 Is azd project 為 true 。
範例提示包括:
- 「我該如何設置一個使用 GitHub Actions 的 CI/CD 管線,將我的應用程式部署到 Azure,且部署選項為『僅部署』,這不是 AZD 專案,且管線平台是『GitHub-actions』?」
| 參數 | 必要或選用 | Description |
|---|---|---|
| 部署選項 | 可選 | 有效值:僅部署、配置與部署。 預設為僅部署。 只有在你明確需要使用本地配置腳本的基礎設施佈署管線時,才需將其設定為 provision-and-deploy 。 |
| AZD 專案是否存在 | 可選 | 是否在部署流程中使用 AZD 工具。 僅在提供true或上下文建議 AZD 工具時才設為azure.yaml。 |
| 管線平台 | 可選 | 部署管道的平台。 有效值: github-actions、 azure-devops。 |
| 破壞性 | 冪等 | 開放世界 | 唯讀 | Secret | 本地必修 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |
取得部署計畫
為應用程式在 Azure 上建立格式化、逐步部署計畫。 此工具是模型情境協定(MCP)的一部分,建議 Azure 資源,提供基礎架構即程式碼(IaC)範本,並根據目標主機服務與所選配置工具列出部署步驟。 例如,目標主機服務包括 Azure 容器應用程式、Azure App 服務 或 Azure Kubernetes Service(AKS)。 配置工具方面,範例包括 Azure Developer CLI (azd)、Azure CLI with Bicep 或 Terraform。
這個工具不會自動掃描你的工作區或偵測資源。 你分析專案,確定框架、依賴與現有資源,選擇主機服務與配置工具,然後提供這些數值以產生計畫。
範例提示包括:
- 「我該如何為名為 'my-webapp' 的專案建立逐步部署計畫到 Azure,並包含部署選項 'provision-and-deploy'、配置工具 'AZD'、來源類型 'from-project'、目標應用程式服務「WebApp'、workspace 資料夾 'home/dev/my-webapp',以及 IaC 選項「bicep'?」
| 參數 | 必要或選用 | Description |
|---|---|---|
| 部署選項 | 可選 | 根據專案和使用者的輸入設定數值。 有效值: provision-and-deploy, deploy-only, provision-only。 選擇 deploy-only 何時部署到現有 Azure 資源,或是在 IaC 檔案已經存在時部署。 選擇 provision-only 僅限於配置 Azure 資源時使用。 選擇 provision-and-deploy 何時要配置基礎設施並部署應用程式。 |
| 專案名稱 | 為必填項目 | 要產生部署計劃的專案名稱。 如果你沒有提供專案名稱,工具會從工作區推斷出名稱。 |
| 佈建工具 | 可選 | 用來佈建 Azure 資源的工具。 有效值: AzCli、 AZD。 例如,Azure Developer CLI (azd) 或 Azure CLI with Bicep。 |
| 來源類型 | 可選 | 計畫生成的來源。 有效值: from-project, from-azure, from-context。 用 from-project 來根據工作區裡的專案檔案來規劃計畫。 用 from-azure 來根據現有的 Azure 資源來規劃。 當沒有專案檔案或 Azure 資源存在時,請用 from-context 你提供的數值來制定計畫。 |
| 目標應用程式服務 | 可選 | 要部署應用程式的 Azure 服務。 有效值: ContainerApp、 WebApp、 FunctionApp、 AKS。 根據應用程式架構和執行環境推薦一個。 |
| 工作區資料夾 | 為必填項目 | 工作區資料夾的完整路徑。 |
| IaC 選項 | 可選 | 基礎設施即程式碼選項。 有效值: bicep、 terraform。 請保持空白以使用 Azure CLI 腳本。 |
| 破壞性 | 冪等 | 開放世界 | 唯讀 | Secret | 必須在本機端執行 |
|---|---|---|---|---|---|
| ❌ | ✅ | ❌ | ✅ | ❌ | ❌ |