Manifestación

Fluir

Servidor MCP de Azure Resource Graph

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que proporciona acceso a consultas de Azure Resource Graph. Permite recuperar información sobre los recursos de Azure en todas las suscripciones mediante consultas de Resource Graph.

Características

• Consultar recursos de Azure mediante consultas de Resource Graph

• La consulta predeterminada devuelve el ID, el nombre, el tipo y la ubicación del recurso.

• Admite consultas de gráficos de recursos personalizados

• Utiliza Azure DefaultAzureCredential para la autenticación

Prerrequisitos

• Node.js instalado

• Suscripción a Azure

• CLI de Azure instalada e iniciada la sesión, u otras credenciales de Azure configuradas

Ejecución del servidor MCP

Puede ejecutar el servidor MCP utilizando Cursor IDE o Visual Studio Code.

Opción 1: Integración de Cursor IDE

Para integrar el servidor MCP con Cursor IDE:

1. Clone este repositorio en su máquina local (por ejemplo, C:\YOUR_WORKSPACE\azure-resource-graph-mcp-server )

2. Construir el proyecto:

3. Abra Configuración del cursor (JSON) y agregue la siguiente configuración:

Nota : asegúrese de actualizar la ruta para que coincida con la ubicación de su repositorio local.

4. Reinicie Cursor IDE para aplicar los cambios

Opción 2: Integración de VS Code

Para integrar el servidor MCP con Visual Studio Code:

1. Clona este repositorio en tu máquina local

2. Construir el proyecto:

3. Abra la configuración de VS Code (JSON) presionando Ctrl+Shift+P , escriba "Configuración (JSON)" y seleccione "Preferencias: Abrir configuración de usuario (JSON)".

4. Agregue la siguiente configuración:

Nota : asegúrese de actualizar la ruta para que coincida con la ubicación de su repositorio local.

5. Guardar el archivo settings.json

6. Reinicie VS Code para aplicar los cambios

El servidor MCP ahora estará disponible para usar dentro de VS Code con integración de cursor.

Uso

El servidor proporciona la siguiente herramienta:

recursos de consulta

Recupera recursos y sus detalles de Azure Resource Graph.

Parámetros:

• subscriptionId (opcional): ID de suscripción de Azure (el valor predeterminado es el ID configurado)

• query (opcional): consulta de gráfico de recursos personalizado (predeterminada en "Recursos | ID del proyecto, nombre, tipo, ubicación")

Configuración del entorno

1. Primero, asegúrese de haber iniciado sesión en la CLI de Azure ejecutando lo siguiente:

   az login

   Este paso es crucial para el desarrollo local ya que DefaultAzureCredential utilizará automáticamente sus credenciales de la CLI de Azure.

2. Configure sus variables de entorno:

   • Copiar .env.example a .env

   • Actualice AZURE_SUBSCRIPTION_ID en .env con su ID de suscripción real

   • Otras variables ( AZURE_TENANT_ID , AZURE_CLIENT_ID , AZURE_CLIENT_SECRET ) son opcionales cuando se usa la autenticación de la CLI de Azure

3. Asegúrese de tener configuradas las credenciales de Azure correctas. El servidor usa DefaultAzureCredential, que admite:

   • CLI de Azure

   • Identidad administrada

   • Credenciales de Visual Studio Code

   • Variables de entorno

4. Si utiliza variables de entorno, configure:

   • ID DE SUSCRIPCIÓN DE AZURE

   • ID DE INQUILINO DE AZURE

   • ID DE CLIENTE DE AZURE

   • SECRETO DEL CLIENTE AZURE

Manejo de errores

El servidor incluye un manejo robusto de errores para:

• Errores de inicialización del cliente de Azure

• Errores de ejecución de consultas

• Consultas o parámetros no válidos

Desarrollo

Para trabajar en este proyecto:

1. Realizar cambios en el directorio src

2. Construir usando npm run build

3. Pruebe sus cambios ejecutando el servidor

Licencia

Este proyecto está licenciado bajo la Licencia MIT. Consulte el archivo de LICENCIA para más detalles.