local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Uses environment variables loaded from .env files to configure the Azure Resource Graph MCP server, particularly for setting up authentication credentials.
Serves as the runtime environment for the Azure Resource Graph MCP server, allowing it to execute Azure Resource Graph queries from within Cursor IDE or VS Code.
Used for package management and build process for the Azure Resource Graph MCP server.

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:

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

npm install
npm run build

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

{
  "mcpServers": {
    "azure-resource-graph-mcp-server": {
      "command": "node",
      "args": [
        "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
      ],
      "env": {
        "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
      },
    }
  }
}

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

Reinicie Cursor IDE para aplicar los cambios

Opción 2: Integración de VS Code

Para integrar el servidor MCP con Visual Studio Code:

Clona este repositorio en tu máquina local
Construir el proyecto:

npm install
npm run build

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)".
Agregue la siguiente configuración:

{
    "mcp": {
        "servers": {
            "azure-resource-graph": {
                "type": "stdio",
                "command": "node",
                "args": [
                    "C:\\YOUR_WORKSPACE\\azure-resource-graph-mcp-server\\build\\index.js"
                ],
                "env": {
                  "SUBSCRIPTION_ID": "xxxxxx-xx-xx-xx-xxxxxx"
                },
            }
        }
    }
}

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

Guardar el archivo settings.json
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

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

Realizar cambios en el directorio src
Construir usando npm run build
Pruebe sus cambios ejecutando el servidor

Licencia

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

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

query-resources

Un servidor de protocolo de contexto de modelo para consultar y analizar recursos de Azure a escala mediante Azure Resource Graph, lo que permite a los asistentes de IA explorar y monitorear la infraestructura de Azure.

Related Resources

Reddit Discussion about this server

Azure Resource Graph MCP Server