Сервер MCP Azure Resource Graph

Демо

Поток

Сервер MCP Azure Resource Graph

Это сервер Model Context Protocol (MCP), который обеспечивает доступ к запросам Azure Resource Graph. Он позволяет вам получать информацию о ресурсах Azure по всем вашим подпискам с помощью запросов Resource Graph.

Функции

Запрос ресурсов Azure с помощью запросов Resource Graph
Запрос по умолчанию возвращает идентификатор ресурса, имя, тип и местоположение.
Поддерживает пользовательские запросы Resource Graph
Использует Azure DefaultAzureCredential для аутентификации

Предпосылки

Node.js установлен
Подписка на Azure
Azure CLI установлен и выполнен вход в систему, или настроены другие учетные данные Azure

Запуск сервера MCP

Вы можете запустить сервер MCP с помощью Cursor IDE или Visual Studio Code.

Вариант 1: Интеграция курсора IDE

Чтобы интегрировать сервер MCP с Cursor IDE:

Клонируйте этот репозиторий на локальный компьютер (например, C:\YOUR_WORKSPACE\azure-resource-graph-mcp-server )
Создайте проект:

npm install
npm run build

Откройте настройки курсора (JSON) и добавьте следующую конфигурацию:

{
  "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"
      },
    }
  }
}

Примечание : обязательно обновите путь в соответствии с расположением вашего локального репозитория.

Перезапустите Cursor IDE, чтобы применить изменения.

Вариант 2: Интеграция VS Code

Чтобы интегрировать сервер MCP с Visual Studio Code:

Клонируйте этот репозиторий на свой локальный компьютер.
Создайте проект:

npm install
npm run build

Откройте настройки VS Code (JSON), нажав Ctrl+Shift+P , введите «Настройки (JSON)» и выберите «Настройки: Открыть настройки пользователя (JSON)».
Добавьте следующую конфигурацию:

{
    "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"
                },
            }
        }
    }
}

Примечание : обязательно обновите путь в соответствии с расположением вашего локального репозитория.

Сохраните файл settings.json
Перезапустите VS Code, чтобы применить изменения.

Сервер MCP теперь будет доступен для использования в VS Code с интеграцией курсора.

Использование

Сервер предоставляет следующий инструмент:

запрос-ресурсы

Извлекает ресурсы и их сведения из Azure Resource Graph.

Параметры:

subscriptionId (необязательно): идентификатор подписки Azure (по умолчанию настроенный идентификатор)
query (необязательно): Пользовательский запрос графика ресурсов (по умолчанию «Ресурсы | идентификатор проекта, имя, тип, местоположение»)

Настройка среды

Сначала убедитесь, что вы вошли в Azure CLI, выполнив следующую команду:
az login
Этот шаг имеет решающее значение для локальной разработки, поскольку DefaultAzureCredential будет автоматически использовать ваши учетные данные Azure CLI.
Настройте переменные среды:
- Копировать .env.example в .env
- Обновите AZURE_SUBSCRIPTION_ID в .env указав ваш фактический идентификатор подписки.
- Другие переменные ( AZURE_TENANT_ID , AZURE_CLIENT_ID , AZURE_CLIENT_SECRET ) являются необязательными при использовании аутентификации Azure CLI.
Убедитесь, что у вас настроены правильные учетные данные Azure. Сервер использует DefaultAzureCredential, который поддерживает:
- Azure-интерфейс командной строки
- Управляемая идентификация
- Учетные данные Visual Studio Code
- Переменные среды
При использовании переменных среды настройте:
- AZURE_SUBSCRIPTION_ID
- AZURE_TENANT_ID
- AZURE_CLIENT_ID
- AZURE_CLIENT_SECRET

Обработка ошибок

Сервер включает в себя надежную обработку ошибок для:

Ошибки инициализации клиента Azure
Ошибки выполнения запроса
Неверные запросы или параметры

Разработка

Для работы над этим проектом:

Внесите изменения в каталог src
Сборка с использованием npm run build
Проверьте свои изменения, запустив сервер.

Лицензия

Этот проект лицензирован по лицензии MIT. Подробности см. в файле LICENSE .

Azure Resource Graph MCP Server

Integrations

Демо

Поток