Azure MCP (Protocolo de contexto de modelo) para Claude Desktop

Una implementación del Protocolo de Contexto de Modelo (MCP) que permite a Claude Desktop interactuar con los servicios de Azure. Esta integración permite a Claude consultar y administrar recursos de Azure directamente mediante conversaciones en lenguaje natural.

Características

• Administración de recursos de Azure : interfaz con el cliente de Administración de recursos de Azure
• Administración de suscripciones : enumere y administre las suscripciones de Azure
• Administración de inquilinos : enumerar y seleccionar inquilinos de Azure
• Autenticación automática : aprovecha DefaultAzureCredential para obtener métodos de autenticación flexibles
• Manejo de errores : Manejo de errores robusto con reintentos para fallas transitorias
• Formato de respuesta limpio : respuestas con el formato correcto compatibles con Claude Desktop

Prerrequisitos

• Node.js (v18 o superior)
• Aplicación de escritorio Claude
• Cuenta de Azure con los permisos adecuados
• CLI de Azure (opcional, para autenticación basada en CLI)

Instalación

Instalación manual

1. Clonar el repositorio:

2. Instalar dependencias:

3. Configurar Claude Desktop:
   • Abra claude_desktop_config.json
   • Agregue la siguiente configuración de MCP:

Autenticación

El servidor admite múltiples métodos de autenticación a través de DefaultAzureCredential:

• Variables de entorno
• Identidad administrada
• CLI de Azure
• Código de Visual Studio
• Navegador interactivo

El servidor probará automáticamente estos métodos en secuencia hasta que uno tenga éxito.

Uso

1. Cierre Claude Desktop si está en ejecución (verifique el Administrador de tareas)
2. Iniciar Claude Desktop
3. En el chat, ahora puedes hacer preguntas relacionadas con Azure como:
   • "¿Puedes obtener todas las cuentas y suscripciones de Azure disponibles?"
   • "Enumerar todos los grupos de recursos en mi suscripción"
   • "Muéstrame todas las máquinas virtuales en un grupo de recursos específico"

Ejemplo de conversación

Desarrollo

Estructura del proyecto

Componentes clave

• AzureMCPServer : clase de servidor principal que implementa el protocolo MCP
• HandleCallTool : procesa solicitudes de herramientas entrantes
• ExecuteWithRetry : implementa lógica de reintento para operaciones resilientes

Solución de problemas

1. Problemas de autenticación :
   • Asegúrese de haber iniciado sesión a través de la CLI de Azure ( az login )
   • Compruebe las variables de entorno si se utiliza la entidad de servicio
   • Verifique que su cuenta de Azure tenga los permisos necesarios
2. Problemas de conexión :
   • Verificar la configuración de Claude Desktop
   • Compruebe que las rutas en el archivo de configuración coincidan con su instalación
   • Asegúrese de que no haya otras instancias en ejecución
3. Errores comunes :
   • NO_TENANT : Seleccione un inquilino usando la herramienta 'seleccionar inquilino'
   • NO_CLIENTS : garantizar la inicialización y autenticación adecuadas
   • CODE_EXECUTION_FAILED : Verificar los permisos y la conexión de Azure

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Colaboradores

• @calclavia - Integración con smithery.ai

Expresiones de gratitud

• Equipo de Claude Desktop para la implementación de MCP
• Equipo de SDK de Azure para el SDK completo
• Protocolo de contexto modelo para permitir la integración de servicios de IA

Nota de seguridad

Esta implementación sigue las mejores prácticas de seguridad de Azure:

• Sin credenciales codificadas
• Implementación de una cadena de credenciales segura
• Manejo adecuado de errores y desinfección

Si tiene inquietudes de seguridad o vulnerabilidades, cree un problema.