Servidor MCP de Azure

El servidor Azure MCP implementa la especificación MCP para crear una conexión perfecta entre los agentes de IA y los servicios clave de Azure, como Azure Storage, Cosmos DB y más.

Tenga en cuenta que este proyecto está en vista previa pública y su implementación puede cambiar significativamente antes de nuestra disponibilidad general.

📑 Índice de contenidos

1. 🎯 Descripción general

2. 🛠️ Herramientas compatibles actualmente

3. 🔌 Instalación y primeros pasos

4. 🧪 Uso del servidor Azure MCP

5. 📝 Solución de problemas

6. 👥 Contribución al servidor Azure MCP

🎯 Descripción general

✨ ¿Qué puedes hacer con Azure MCP Server?

El servidor Azure MCP potencia a tus agentes con el contexto de Azure. Aquí tienes algunas sugerencias interesantes que puedes probar:

🔍 Explora tus recursos de Azure

• "Enumerar mis cuentas de almacenamiento de Azure"

• "Muéstrame todas mis bases de datos de Cosmos DB"

• "¿Qué índices tengo en mi servicio Azure AI Search 'mysvc'?"

• "Enumerar mis grupos de recursos"

• "Muéstrame las tablas en mi cuenta de almacenamiento"

• "Enumerar contenedores en mi base de datos Cosmos DB"

• Obtener detalles sobre mi contenedor de almacenamiento

• Obtener las bases de datos de Kusto en el clúster 'mycluster'

• Muestra de 10 filas de la tabla 'StormEvents' en la base de datos Kusto 'db1'.

📊 Consultar y analizar

• Consultar mi espacio de trabajo de Log Analytics

• "Busquemos en este índice 'mi consulta de búsqueda'"

⚙️ Administrar configuración

• "Enumerar mis tiendas de configuración de aplicaciones"

• Mostrar mis pares clave-valor en la configuración de la aplicación

Operaciones avanzadas de Azure

• "Enumerar mis puntos de conexión de Azure CDN"

• Ayúdame a crear una aplicación de Azure con Node.js.

🔍 Cómo funciona

El servidor Azure MCP crea una integración perfecta entre los agentes de IA y los servicios de Azure a través de:

• Comunicación JSON inteligente que los agentes de IA entienden

• 🏗️ Comandos en lenguaje natural que se traducen a operaciones de Azure

• 💡 Sugerencias de parámetros inteligentes y autocompletado

• ⚡ Manejo de errores consistente y con sentido

🛠️ Herramientas compatibles actualmente

El servidor MCP de Azure proporciona herramientas para interactuar con los siguientes servicios de Azure:

🔎 Azure AI Search (motor de búsqueda/base de datos vectorial)

• Enumerar los servicios de Azure AI Search

• Enumere los índices y observe su esquema y configuración

• Índices de búsqueda de consultas

📊 Azure Cosmos DB (bases de datos NoSQL)

• Lista de cuentas de Cosmos DB

• Listar y consultar bases de datos

• Administrar contenedores y artículos

• Ejecutar consultas SQL contra contenedores

🐘 Azure Database for PostgreSQL: servidor flexible

• Enumerar y consultar bases de datos.

• Enumerar y obtener el esquema de las tablas.

• Listar, obtener configuración y obtener parámetros para los servidores.

🧮 Kusto (Explorador de datos de Azure)

• Lista de clústeres de Kusto

• Listar bases de datos en un clúster de Kusto

• Listar tablas en una base de datos de Kusto

• Obtener el esquema para una tabla Kusto

• Filas de muestra de una tabla Kusto

• Consultar bases de datos de Kusto usando KQL

Almacenamiento de Azure

• Lista de cuentas de almacenamiento

• Administrar contenedores de blobs y blobs

• Listar y consultar tablas de almacenamiento

• Obtener propiedades y metadatos del contenedor

📈 Azure Monitor (Análisis de registros)

• Lista de espacios de trabajo de Log Analytics

• Consultar registros mediante KQL

• Lista de mesas disponibles

⚙️ Configuración de la aplicación de Azure

• Lista de tiendas de configuración de aplicaciones

• Administrar pares clave-valor

• Manejar configuraciones etiquetadas

• Bloquear/desbloquear la configuración

Almacén de claves de Azure

• Listar, crear y obtener claves

📦 Grupos de recursos de Azure

• Lista de grupos de recursos

🚌 Bus de servicio de Azure

• Examinar las propiedades y la información de tiempo de ejecución sobre colas, temas y suscripciones

Extensión CLI de Azure

• Ejecutar comandos de la CLI de Azure directamente

• Compatibilidad con todas las funciones de la CLI de Azure

• Formato de salida JSON

• Compatibilidad entre plataformas

Extensión CLI para desarrolladores de Azure (azd)

• Ejecutar comandos CLI de Azure Developer directamente

• Soporte para descubrimiento de plantillas, inicialización de plantillas, aprovisionamiento e implementación

• Compatibilidad entre plataformas

Los agentes y modelos pueden descubrir y aprender las mejores prácticas y pautas de uso de la herramienta azd MCP. Para obtener más información, consulte las mejores prácticas de AZD .

🛡️ Prácticas recomendadas de Azure

• Obtenga las mejores prácticas seguras y de nivel de producción del SDK de Azure para una generación de código efectiva.

Para obtener documentación detallada y ejemplos de comandos, consulte Comandos de Azure MCP .

🔌 Primeros pasos

El servidor Azure MCP requiere Node.js para su instalación y ejecución. Si no lo tiene instalado, siga las instrucciones aquí .

VS Code + GitHub Copilot

Azure MCP Server proporciona herramientas para desarrolladores del SDK de Azure y la CLI de Azure. Puede usarse solo o con la extensión GitHub Copilot para Azure en VS Code. Si le interesa obtener un amplio soporte para desarrolladores en diversos escenarios de desarrollo de Azure no incluidos en Azure MCP Server, como la búsqueda de documentación en Microsoft Learn, también le recomendamos esta extensión.

Prerrequisitos

1. Instale la versión estable o Insiders de VS Code:

   • 💫 Versión estable

   • 🔮 Comunicado de prensa de Insiders

2. Instalar las extensiones GitHub Copilot y GitHub Copilot Chat

3. Instalar Node.js 20 o posterior

   • Asegúrese de que node y npm estén en su ruta

4. Abra VS Code en una carpeta vacía

Instalación

✨ Instalación con un solo clic

Haga clic en uno de estos botones para instalar Azure MCP Server para VS Code o VS Code Insiders.

Una vez instalado Azure MCP Server, asegúrese de seleccionar el modo de agente de GitHub Copilot y actualice la lista de herramientas. Para obtener más información sobre el modo de agente, visite la documentación de VS Code .

🔧 Instalación manual

Para una instalación paso a paso, siga estas instrucciones:

1. Agregar .vscode/mcp.json :

Instalación de Docker

Para una instalación paso a paso, siga estas instrucciones:

1. Repositorio de clones

2. Desde la raíz del repositorio, cree una imagen de Docker: docker build -t azure/azuremcp .

3. Cree un archivo .env con variables de entorno que coincidan con uno de los conjuntos . Por ejemplo, un archivo .env que utilice una entidad de servicio podría tener el siguiente aspecto:

1. Agregue .vscode/mcp.json o actualice la configuración de MCP existente. Reemplace /full/path/to/.env con la ruta a su archivo .env .

Opcionalmente, los clientes pueden usar --env o --volume para pasar valores de autenticación.

🧪 Pruebe el servidor Azure MCP

1. Abra GitHub Copilot en VS Code y cambie al modo Agente

2. Debería ver Azure MCP Server en la lista de herramientas

3. Pruebe con un mensaje que le indique al agente que use el servidor Azure MCP, como "Enumerar mis contenedores de Azure Storage".

4. El agente debe poder usar las herramientas de Azure MCP Server para completar su consulta

🤖 Clientes MCP personalizados

Puede configurar fácilmente su cliente MCP para usar Azure MCP Server. Ejecute el siguiente comando y acceda a él mediante E/S estándar o SSE.

Uso de E/S estándar

Configure el cliente MCP para ejecutar: npx -y @azure/mcp@latest server start . Para obtener instrucciones sobre el uso de VS Code, siga las instrucciones en Instalación en un clic o Instalación manual .

Uso de SSE

1. Abra una ventana de terminal y ejecute: npx -y @azure/mcp@latest server start --transport sse

2. El servidor se inicia y se aloja en: http://localhost:5008 . Para usar otro puerto, añada --port {YOUR-PORT-NUMBER} .

3. Abra su cliente MCP y agregue el valor de configuración de SSE. Esto puede variar entre clientes MCP. En VS Code, se verá así:

   { "servers": { "Azure MCP Server": { "type": "sse", "url": "http://localhost:5008/sse" } } }

¡Pronto habrá más guías de agente/cliente MCP de extremo a extremo!

📝 Solución de problemas

Consulte la guía de solución de problemas para obtener ayuda con problemas comunes y registros.

🔑 Autenticación

El servidor Azure MCP se integra a la perfección con los mecanismos de autenticación del sistema operativo del host, lo que facilita enormemente el inicio. Usamos Azure Identity en segundo plano mediante DefaultAzureCredential , que prueba estas credenciales en orden:

1. Variables de entorno ( EnvironmentCredential ): perfectas para pipelines de CI/CD

2. Caché de token compartido ( SharedTokenCacheCredential ): utiliza tokens almacenados en caché de otras herramientas

3. Visual Studio ( VisualStudioCredential ): utiliza sus credenciales de Visual Studio

4. CLI de Azure ( AzureCliCredential ): utiliza su inicio de sesión de CLI de Azure existente

5. Azure PowerShell ( AzurePowerShellCredential ): utiliza su inicio de sesión de Az PowerShell

6. CLI para desarrolladores de Azure ( AzureDeveloperCliCredential ): utiliza su inicio de sesión de azd

7. Navegador interactivo ( InteractiveBrowserCredential ): recurre al inicio de sesión basado en navegador si es necesario

Si ya ha iniciado sesión mediante alguno de estos métodos, Azure MCP Server usará automáticamente esas credenciales. Asegúrese de tener los permisos de autorización correctos en Azure (por ejemplo, acceso de lectura a su cuenta de almacenamiento) mediante RBAC (Control de acceso basado en roles). Para obtener más información sobre el sistema de autorización RBAC de Azure, visite este enlace .

Si tiene algún problema con la autenticación, visite nuestra guía de solución de problemas .

Credenciales de producción

De forma predeterminada, Azure MCP Server excluye las credenciales de producción, como Identidad administrada e Identidad de carga de trabajo. Para habilitar estas credenciales, configure la variable de entorno:

Esto es útil cuando se ejecuta en servicios de Azure donde desea utilizar identidades administradas.

🛡️ Nota de seguridad

Sus credenciales siempre se manejan de forma segura a través del SDK oficial de Azure Identity : nunca almacenamos ni administramos tokens directamente .

El fenómeno MCP es muy novedoso y vanguardista. Al igual que con todos los nuevos estándares tecnológicos, considere realizar una revisión de seguridad para garantizar que todos los sistemas que se integran con servidores MCP cumplan con todas las regulaciones y estándares que se espera que su sistema cumpla. Esto incluye no solo el servidor Azure MCP, sino también cualquier cliente/agente MCP que decida implementar, incluyendo el proveedor del modelo.

👥 Contribuyendo

¡Agradecemos sus contribuciones al servidor Azure MCP! Ya sea que esté corrigiendo errores, agregando nuevas características o mejorando la documentación, sus contribuciones son bienvenidas.

Lea nuestra Guía de contribución para obtener pautas sobre:

• 🛠️ Configurando tu entorno de desarrollo

• ✨Añadiendo nuevos comandos

• 📝 Requisitos de estilo y pruebas de código

• 🔄 Realizar solicitudes de extracción

🤝 Código de conducta

Este proyecto ha adoptado el Código de Conducta de Código Abierto de Microsoft . Para más información, consulte las preguntas frecuentes sobre el Código de Conducta o escriba a opencode@microsoft.com si tiene alguna pregunta o comentario.