Herramientas del servidor MCP de Azure para Azure Deploy

El servidor MCP de Azure le ayuda a administrar las tareas de Implementación de Azure. Estas tareas incluyen operaciones que generan diagramas de arquitectura, obtienen registros de aplicaciones, recuperan planes de implementación, capturan reglas de IaC y proporcionan instrucciones de canalización, todo a través de mensajes de lenguaje natural.

Azure Deploy es un conjunto de herramientas que le ayudan a planear, validar y supervisar implementaciones en los recursos de Azure. Para más información, consulte la documentación de Implementación de Azure.

Nota:

Parámetros de herramienta: las herramientas del servidor MCP de Azure definen parámetros para los datos que necesitan para completar las tareas. Algunos de estos parámetros son específicos de cada herramienta y se documentan a continuación. Otros parámetros son globales y compartidos por todas las herramientas. Para obtener más información, consulte Parámetros de la herramienta.

Obtención de registros de aplicaciones

Esta herramienta muestra los registros de aplicaciones para las aplicaciones que implementa la CLI para desarrolladores de Azure (azd). Esta herramienta consulta el área de trabajo de Log Analytics de la aplicación para Azure Container Apps, Azure App Service y Azure Functions. Detecta automáticamente el área de trabajo y los recursos asociados de la configuración del entorno azd. Solo funciona para las aplicaciones implementadas por azd up.

Compruebe el estado de implementación o solucione problemas posteriores a la implementación.

Algunas solicitudes de ejemplo incluyen:

  • Muéstrame el registro de la aplicación implementada por azd para el nombre del entorno Azd 'dev' y la carpeta de trabajo '/home/alice/projects/my-app'.
Parámetro Obligatorio u opcional Description
Nombre de entorno AZD Obligatorio Nombre del entorno creado por la CLI para desarrolladores de Azure (azd) y almacenado en AZURE_ENV_NAME durante azd init o azd up. Si no se proporciona en contexto, esta herramienta comprueba el directorio .azure en el área de trabajo o ejecuta azd env list.
Carpeta del área de trabajo Obligatorio Ruta de acceso completa a la carpeta del área de trabajo que contiene el proyecto azd.
Límite Opcional Número máximo de filas de registro a recuperar. Úselo para limitar los resultados o evitar superar los límites de token. El valor predeterminado es 200.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Se requiere local: ❌

Generar diagrama de arquitectura

Esta herramienta forma parte del conjunto de herramientas del Protocolo de contexto de modelos (MCP). Genera un diagrama de arquitectura de servicio de Azure que muestra los servicios de Azure recomendados y sus conexiones lógicas para una aplicación. Esta herramienta representa el diagrama de una topología de aplicación (AppTopology) proporcionada como entrada. Proporcionas una "AppTopology" que describe los servicios, los hosts de proceso, las dependencias y la configuración del entorno. Puede compilar la appTopology examinando el área de trabajo para detectar servicios, marcos y variables de entorno para las cadenas de conexión. En el caso de las aplicaciones de .NET Aspire, incluya aspireManifest.json. El diagrama se centra en la selección y las conexiones del servicio. No muestra la topología de red detallada ni el diseño de seguridad.

Algunas solicitudes de ejemplo incluyen:

  • Genere el diagrama de arquitectura de Azure para esta aplicación mediante la entrada sin procesar de la herramienta MCP "<secure-password>".
Parámetro Obligatorio u opcional Description
Entrada sin procesar de la herramienta mcp Obligatorio Objeto JSON que define la estructura de entrada de esta herramienta.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Se requiere local: ❌

Obtén reglas de IaC

Recupera reglas y procedimientos recomendados para crear archivos de infraestructura de Bicep y Terraform como código (IaC) para implementar aplicaciones de Azure. Esta herramienta de Protocolo de contexto de modelo (MCP) devuelve instrucciones sobre los estándares de configuración de recursos de Azure, la compatibilidad con la CLI para desarrolladores de Azure (azd) y la CLI de Azure, y los requisitos generales de calidad de IaC. Use las instrucciones para mejorar los scripts de Bicep y las plantillas de Terraform para los recursos de Azure y para alinear las implementaciones con los procedimientos recomendados de Azure.

Algunas solicitudes de ejemplo incluyen:

  • "Mostrar las reglas y los procedimientos recomendados para escribir Bicep y Terraform IaC para Azure mediante la herramienta de implementación "AzCli".
Parámetro Obligatorio u opcional Description
Herramienta de implementación Obligatorio Herramienta de implementación que se va a usar. Valores válidos: AzCli, AZD.
Tipo IaC Opcional Tipo de archivo IaC usado para la implementación. Los valores válidos incluyen bicep, terraform. Deje vacío solo si desea usar el script de comandos de la CLI de Azure sin archivo IaC.
Tipos de recursos Opcional Lista de tipos de recursos de Azure para los que se van a generar reglas. Obtenga el valor del contexto y use los mismos recursos definidos en el plan. Valor válido: appservice,containerapp,function,aks,azuredatabaseforpostgresql,azuredatabaseformysqlazuresqldatabase,azurecosmosdb,.azurestorageaccountazurekeyvault

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Se requiere local: ❌

Ejemplos

  • Proporcione reglas de IaC para Bicep y Terraform para Azure App Service y Azure SQL Database: "Obtener reglas para la herramienta de implementación "AZD" y el tipo IaC "bicep" para los recursos "appservice", "azuresqldatabase".
  • Mostrar las prácticas recomendadas para una plantilla de Terraform que despliegue Azure Kubernetes Service y Azure Key Vault: «Obtener reglas para la herramienta de implementación "AzCli" y el tipo de IaC "terraform" para los recursos "aks" y "azurekeyvault».
  • Solicitar comprobaciones generales de calidad de IaC sin un archivo IaC, utilizando un script de AzCli: "Obtén las reglas para la herramienta de implementación 'AzCli' y deja el tipo de IaC vacío para los recursos 'azurestorageaccount'".

Obtención de instrucciones de canalización

Esta herramienta de Protocolo de contexto de modelo (MCP) genera la configuración de canalización de CI/CD y una guía paso a paso para implementar una aplicación en Azure mediante acciones de GitHub o canalizaciones de Azure DevOps. Admite implementaciones basadas en Azure Developer CLI (azd) y en la CLI de Azure. Puede generar canalizaciones que aprovisionen la infraestructura e implementen código de aplicación.

Puede elegir Acciones de GitHub o Azure DevOps, decidir si la canalización solo debe implementar o también aprovisionar la infraestructura y confirmar si el proyecto usa azd (por ejemplo, un azure.yaml archivo está presente). Especifique deploy-only o provision-and-deploy, y establezca Is azd project a true solo si el proyecto usa el conjunto de herramientas azd y está disponible un archivo azure.yaml.

Algunas solicitudes de ejemplo incluyen:

  • "¿Cómo puedo configurar una canalización de CI/CD con Acciones de GitHub para desplegar mi aplicación en Azure, con la opción de implementación 'deploy-only', que no es un proyecto AZD y la plataforma de canalización 'github-actions'?"
Parámetro Obligatorio u opcional Description
Opción De implementación Obligatorio Valores válidos: solo desplegar, aprovisionar y desplegar. Configuración predeterminada para solo desplegar. Solo establézcalo en provision-and-deploy cuando desee explícitamente una canalización de aprovisionamiento de infraestructuras que use scripts de aprovisionamiento local.
Es el proyecto AZD Obligatorio Si se va a usar la herramienta AZD en la canalización de implementación. true Establézcalo en solo si azure.yaml se proporciona o el contexto sugiere herramientas de AZD.
Plataforma de canalización Obligatorio Plataforma para la canalización de implementación. Valores válidos: github-actions, azure-devops.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Se requiere local: ❌

Obtención del plan de implementación

Genera un plan de implementación paso a paso con formato para una aplicación en Azure. Esta herramienta, parte del Protocolo de contexto de modelo (MCP), sugiere recursos de Azure, proporciona plantillas de infraestructura como código (IaC) y enumera los pasos de implementación basados en un servicio de hospedaje de destino y una herramienta de aprovisionamiento elegida. Por ejemplo, los servicios de hospedaje de destino incluyen Azure Container Apps, Azure App Service o Azure Kubernetes Service (AKS). Para las herramientas de aprovisionamiento, entre los ejemplos se incluyen la CLI para desarrolladores de Azure (azd), la CLI de Azure con Bicep o Terraform.

Esta herramienta no examina el área de trabajo ni detecta recursos automáticamente. Analice el proyecto, determine marcos, dependencias y recursos existentes, elija el servicio de hospedaje y la herramienta de aprovisionamiento y proporcione esos valores para generar el plan.

Algunas solicitudes de ejemplo incluyen:

  • "¿Cómo se crea un plan de implementación paso a paso para el nombre de proyecto "my-webapp" en Azure con la opción de implementación "provision-and-deploy", la herramienta de aprovisionamiento "AZD", el tipo de origen "from-project", el servicio de aplicaciones de destino "WebApp", la carpeta del área de trabajo "/home/dev/my-webapp" y las opciones de IaC "bicep"?"
Parámetro Obligatorio u opcional Description
Opción De implementación Obligatorio Establezca el valor en función de la entrada del proyecto y del usuario. Valores válidos: provision-and-deploy, deploy-only, provision-only. Elija deploy-only al implementar en recursos de Azure existentes o cuando ya existan archivos IaC. Elija provision-only cuando solo quiera aprovisionar recursos de Azure. Elija provision-and-deploy cuándo desea aprovisionar la infraestructura e implementar la aplicación.
Nombre del proyecto Obligatorio Nombre del proyecto para el que se va a generar el plan de implementación. Si no proporciona un nombre de proyecto, la herramienta lo deduce del área de trabajo.
Herramienta de aprovisionamiento Obligatorio Herramienta que se va a usar para el aprovisionamiento de recursos de Azure. Valores válidos: AzCli, AZD. Por ejemplo, la CLI para desarrolladores de Azure (azd) o la CLI de Azure con Bicep.
Tipo de origen Obligatorio Origen del plan desde el que se va a generar. Valores válidos: from-project, from-azure, from-context. Use from-project para basar el plan en los archivos del proyecto en el área de trabajo. Use from-azure para basar el plan en los recursos de Azure existentes. Use from-context para basar el plan en los valores que proporcione cuando no existan archivos de proyecto ni recursos de Azure.
Servicio de aplicaciones de destino Obligatorio Servicio de Azure para implementar la aplicación. Valores válidos: ContainerApp, WebApp, FunctionApp, AKS. Se recomienda uno basado en la arquitectura y el tiempo de ejecución de la aplicación.
Carpeta del área de trabajo Obligatorio Ruta de acceso completa del directorio del área de trabajo.
Opciones de IaC Opcional La opción Infraestructura como código. Valores válidos: bicep, terraform. Deje vacío para usar un script de la CLI de Azure.
Grupo de recursos Opcional Nombre del grupo de recursos de Azure.

Sugerencias de anotación de herramientas:

Destructiva: ❌ | Idempotente: ✅ | Mundo Abierto: ❌ | Solo lectura: ✅ | Secreto: ❌ | Se requiere local: ❌

Contenido relacionado

  • Last updated on