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.

🎯 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"
"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

📊 Consultar y analizar

Consultar mi espacio de trabajo de Log Analytics

⚙️ 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 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

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
Configurar las opciones de monitorización

⚙️ 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

📦 Grupos de recursos de Azure

Lista de grupos de recursos
Operaciones de gestión de grupos de recursos

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

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 del plano de datos de Azure. Se puede usar 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

Instale la versión estable o Insiders de VS Code:
- 💫 Versión estable
- 🔮 Comunicado de prensa de Insiders
Instalar las extensiones GitHub Copilot y GitHub Copilot Chat
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:

Agregar .vscode/mcp.json :

{
  "servers": {
    "Azure MCP Server": {
      "command": "npx",
      "args": [
        "-y",
        "@azure/mcp@latest",
        "server",
        "start"
      ]
    }
  }
}

🧪 Pruebe el servidor Azure MCP

Abra GitHub Copilot en VS Code y cambie al modo Agente
Debería ver Azure MCP Server en la lista de herramientas
Pruebe con un mensaje que le indique al agente que use el servidor Azure MCP, como "Enumerar mis contenedores de Azure Storage".
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. Haga que su cliente 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

Abra una ventana de terminal y ejecute: npx -y @azure/mcp@latest server start --transport sse
El servidor se inicia y se aloja en: http://localhost:5008 . Para usar otro puerto, añada --port {YOUR-PORT-NUMBER} .
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:

Variables de entorno ( EnvironmentCredential ): perfectas para pipelines de CI/CD
Caché de token compartido ( SharedTokenCacheCredential ): utiliza tokens almacenados en caché de otras herramientas
Visual Studio ( VisualStudioCredential ): utiliza sus credenciales de Visual Studio
CLI de Azure ( AzureCliCredential ): utiliza su inicio de sesión de CLI de Azure existente
Azure PowerShell ( AzurePowerShellCredential ): utiliza su inicio de sesión de Az PowerShell
CLI para desarrolladores de Azure ( AzureDeveloperCliCredential ): utiliza su inicio de sesión de azd
Navegador interactivo ( InteractiveBrowserCredential ): recurre al inicio de sesión basado en navegador si es necesario

Si ya ha iniciado sesión a través de alguno de estos métodos, Azure MCP Server utilizará automáticamente esas credenciales.

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:

AZURE_MCP_INCLUDE_PRODUCTION_CREDENTIALS=true

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 su 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.

Integrations