Ferramentas do servidor MCP do Azure para implementação no Azure

O Azure MCP Server ajuda-o a gerir tarefas do Azure Deploy. Estas tarefas incluem operações que geram diagramas de arquitetura, obtêm logs de aplicações, recuperam planos de implementação, obtêm regras IaC e fornecem orientação para pipelines, tudo através de prompts em linguagem natural.

O Azure Deploy é um conjunto de ferramentas que o ajudam a planear, validar e monitorizar implementações nos recursos do Azure. Para mais informações, consulte a documentação do Azure Deploy.

Note

Parâmetros de ferramenta: As ferramentas do Azure MCP Server definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados abaixo. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte Parâmetros da ferramenta.

Obtenha registos da aplicação

Esta ferramenta mostra registos de aplicações para aplicações que o Azure Developer CLI (azd) implementa. Esta ferramenta consulta o espaço de trabalho Log Analytics da aplicação para Azure Container Apps, Azure App Service e Azure Functions. Descobre automaticamente o espaço de trabalho e os recursos associados a partir da configuração do ambiente azd. Funciona apenas para aplicações implementadas por azd up.

Verifique o estado da implementação ou resolva problemas após a implementação.

Exemplos de prompts incluem:

  • "Mostra-me o registo da aplicação implementada pelo azd para o nome ambiental do Azd 'dev' e a pasta do espaço de trabalho '/home/alice/projects/my-app'."
Parâmetro Obrigatório ou opcional Description
Nome do ambiente AZD Obrigatório O nome do ambiente criado pelo Azure Developer CLI (azd) e armazenado em AZURE_ENV_NAME durante azd init ou azd up. Se não for fornecido no contexto, esta ferramenta verifica o diretório .azure no espaço de trabalho, ou executa azd env list.
Pasta do espaço de trabalho Obrigatório O caminho completo para a pasta do workspace que contém o projeto azd.
Limit Opcional O número máximo de linhas de log para recuperar. Use-o para limitar resultados ou evitar ultrapassar os limites de tokens. O padrão é 200.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Gerar diagrama de arquitetura

Esta ferramenta faz parte do conjunto de ferramentas Model Context Protocol (MCP). Gera um diagrama de arquitetura de serviços Azure que mostra os serviços Azure recomendados e as suas ligações lógicas para uma aplicação. Esta ferramenta renderiza o diagrama a partir de uma topologia de aplicação (AppTopology) fornecida como entrada. Você fornece um "AppTopology" que descreve serviços, hosts de computação, dependências e definições de ambiente. Pode construir o AppTopology analisando o espaço de trabalho para detetar serviços, frameworks e variáveis de ambiente para strings de ligação. Para aplicações .NET Aspire, inclua aspireManifest.json. O diagrama foca-se na seleção de serviços e nas ligações. Não mostra topologia detalhada da rede nem design de segurança.

Exemplos de prompts incluem:

  • Gerar o diagrama de arquitetura do Azure para esta aplicação com a entrada bruta da ferramenta MCP '<secure-password>'.
Parâmetro Obrigatório ou opcional Description
Entrada bruta da ferramenta mcp Obrigatório Objeto JSON que define a estrutura de entrada desta ferramenta.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha as regras do IaC

Recupera regras e boas práticas para criar ficheiros Infrastructure as Code (IaC) em Bicep e Terraform para implementar as aplicações Azure. Esta ferramenta Model Context Protocol (MCP) devolve orientações sobre padrões de configuração de recursos Azure, compatibilidade com Azure Developer CLI (azd) e Azure CLI, e requisitos gerais de qualidade IaC. Use as orientações para melhorar os scripts do Bicep e os templates Terraform para os recursos do Azure e para alinhar as implementações com as melhores práticas do Azure.

Exemplos de prompts incluem:

  • "Mostra-me as regras e boas práticas para escrever Bicep e Terraform IaC para Azure usando a ferramenta de implementação 'AzCli'."
Parâmetro Obrigatório ou opcional Description
Ferramenta de implantação Obrigatório A ferramenta de implantação a ser usada. Valores válidos: AzCli, AZD.
Tipo IaC Opcional O tipo de ficheiro IaC usado para implementação. Os valores válidos incluem bicep, terraform. Deixa vazio apenas se quiseres usar o script de comandos Azure CLI sem ficheiro IaC.
Tipos de recursos Opcional Lista de tipos de recursos Azure para gerar regras. Obtenha o valor do contexto e use os mesmos recursos definidos no plano. Valor válido: appservice,containerapp,functionaks,azuredatabaseforpostgresql,,azuredatabaseformysql,azuresqldatabase.azurecosmosdbazurestorageaccountazurekeyvault

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Examples

  • Forneça regras de IaC para Bicep e Terraform para Azure App Service e Azure SQL Database: "Obtenha regras para a ferramenta de implementação 'AZD' e para o tipo de IaC 'bicep' relativamente aos recursos 'appservice' e 'azuresqldatabase'".
  • Mostre as melhores práticas para um modelo Terraform que implanta o Azure Kubernetes Service e o Azure Key Vault: "Obtenha regras para a ferramenta de implementação 'AzCli' e para o tipo de IaC 'terraform' para os recursos 'aks', 'azurekeyvault'".
  • Solicite verificações gerais de qualidade para IaC sem um ficheiro IaC, utilizando um script AzCli: "Obtenha regras para a ferramenta de implementação 'AzCli' e deixe o tipo IaC vazio para recursos 'azurestorageaccount'".

Obtenha orientação para pipelines

Esta ferramenta do Modelo de Protocolo de Contexto (MCP) gera a configuração do pipeline CI/CD e fornece orientações passo a passo para implantar uma aplicação no Azure, usando GitHub Actions ou pipelines do Azure DevOps. Suporta implementações baseadas em Azure Developer CLI (azd) e Azure CLI. Pode gerar pipelines que fornecem infraestrutura e implementam código de aplicação.

Podes escolher GitHub Actions ou Azure DevOps, decidir se o pipeline deve apenas implementar ou também provisionar infraestrutura, e confirmar se o projeto usa azd (por exemplo, se há um azure.yaml ficheiro presente). Especifique deploy-only ou provision-and-deploy, e defina Is azd project para true apenas se o projeto usar ferramentas azd e estiver disponível um ficheiro azure.yaml.

Exemplos de prompts incluem:

  • "Como é que configuro um pipeline CI/CD com GitHub Actions para implementar a minha aplicação no Azure, com a opção Deploy 'deploy-only', não é um projeto AZD, e a plataforma de pipeline é 'github-actions'?"
Parâmetro Obrigatório ou opcional Description
Opção de implantação Obrigatório Valores válidos: apenas deploy, provision-and-deploy. Por padrão, apenas implementar. Defina como provision-and-deploy apenas quando quiser explicitamente um pipeline de provisionamento de infraestrutura que use scripts de provisionamento locais.
É o projeto AZD Obrigatório Se deve usar a ferramenta AZD no pipeline de implementação. Defina apenas true se azure.yaml for aplicado ou se o contexto indicar a utilização de ferramentas AZD.
Plataforma de gasoduto Obrigatório A plataforma do pipeline de implementação. Valores válidos: github-actions, azure-devops.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Obtenha o plano de desdobramento

Gera um plano de implementação formatado, passo a passo, para uma aplicação no Azure. Esta ferramenta, parte do Model Context Protocol (MCP), sugere recursos Azure, fornece templates de infraestrutura como código (IaC) e lista os passos de implementação com base num serviço de alojamento alvo e numa ferramenta de provisionamento escolhida. Por exemplo, os serviços de alojamento alvo incluem Azure Container Apps, Azure App Service ou Azure Kubernetes Service (AKS). Para ferramentas de provisionamento, exemplos incluem Azure Developer CLI (azd), Azure CLI com Bicep ou Terraform.

Esta ferramenta não escaneia o seu espaço de trabalho nem deteta recursos automaticamente. Analisa o projeto, determina frameworks, dependências e recursos existentes, escolhe o serviço de alojamento e a ferramenta de provisionamento, e depois fornece esses valores para gerar o plano.

Exemplos de prompts incluem:

  • Como posso criar um plano de implementação passo a passo para o projeto chamado 'my-webapp' para o Azure com a opção de implementação 'provision-and-deploy', ferramenta de provisionamento 'AZD', tipo de fonte 'from-project', serviço de aplicação alvo 'WebApp', diretório de trabalho '/home/dev/my-webapp' e opções IaC 'bicep'?
Parâmetro Obrigatório ou opcional Description
Opção de implantação Obrigatório Defina o valor com base no projeto e na entrada do utilizador. Valores válidos: provision-and-deploy, deploy-only, provision-only. Escolhe deploy-only quando implementas para os recursos existentes do Azure ou quando os ficheiros IaC já existem. Escolhe provision-only quando só queres provisionar recursos Azure. Escolha provision-and-deploy quando quer provisionar a infraestrutura e implementar a aplicação.
Nome do projeto Obrigatório O nome do projeto para o qual gerar o plano de implantação. Se não fornecer um nome de projeto, a ferramenta infere isso a partir do espaço de trabalho.
Ferramenta de provisionamento Obrigatório A ferramenta a ser usada para provisionar recursos do Azure. Valores válidos: AzCli, AZD. Por exemplo, Azure Developer CLI (azd) ou Azure CLI com Bicep.
Tipo de fonte Obrigatório A fonte a partir da qual gerar o plano. Valores válidos: from-project, from-azure, from-context. Use from-project para basear o plano nos ficheiros do projeto no espaço de trabalho. Use from-azure para basear o plano nos recursos existentes do Azure. Usa from-context para basear o plano nos valores que forneces quando não existem ficheiros de projeto ou recursos do Azure.
Serviço de aplicativo de destino Obrigatório O serviço do Azure para implantar o aplicativo. Valores válidos: ContainerApp, WebApp, FunctionApp, AKS. Recomendo um com base na arquitetura da aplicação e no tempo de execução.
Pasta do espaço de trabalho Obrigatório O caminho completo da pasta de espaço de trabalho.
Opções IaC Opcional A opção Infraestrutura como Código. Valores válidos: bicep, terraform. Deixe vazio para usar um script Azure CLI.
Grupo de recursos Opcional O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destruidor: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente Leitura: ✅ | Segredo: ❌ | Local Obrigatório: ❌

Conteúdo relacionado

  • Last updated on