Skip to main content
Glama
deenesjakoruzh

ms-sentinel-mcp-server

by dstreefkerk
GitHub
Python
MIT License
9
  • Linux
OverviewInspectNewEndpointsSchemaRelated ServersReviewsScore
Need Help?View Source CodeReport Issue

Сервер Microsoft Sentinel MCP

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

⚠️ ВАЖНОЕ УВЕДОМЛЕНИЕ О БЕЗОПАСНОСТИ ⚠️

ТОЛЬКО ДЛЯ ТЕСТОВЫХ СРЕД : Этот сервер Microsoft Sentinel MCP поддерживает только операции только для чтения и предназначен исключительно для ТЕСТОВЫХ сред. Он не предназначен для подключения к производственным экземплярам Sentinel.

ПРЕДУПРЕЖДЕНИЕ О КОНФИДЕНЦИАЛЬНОСТИ : подключение этого сервера к производственной среде Microsoft Entra ID (Azure AD) или Sentinel может раскрыть конфиденциальные данные пользователя и каталога операторам LLM или публичным LLM. Используйте только с непроизводственными/тестовыми арендаторами или частным LLM с поддержкой MCP.

ПРЕДУПРЕЖДЕНИЕ О БЕЗОПАСНОСТИ : Подключение производственного экземпляра Microsoft Sentinel к публичному LLM представляет значительные риски конфиденциальности и безопасности. Используйте только частные, защищенные среды для производственных операций по безопасности.

✨ Особенности

  • Выполнение запросов KQL : запуск и проверка запросов KQL, тестирование с использованием фиктивных данных.

  • Управление аналитикой журналов : информация о рабочем пространстве, списки таблиц и схемы

  • Инциденты безопасности : список и просмотр подробной информации об инцидентах

  • Правила аналитики : список, просмотр и анализ по тактикам/методам MITRE

  • Шаблоны правил : доступ к шаблонам и их анализ с помощью фреймворка MITRE

  • Запросы на охоту : список, просмотр деталей и анализ по тактике

  • Коннекторы данных : список и просмотр сведений о коннекторах

  • Списки наблюдения : управление списками наблюдения и их элементами.

  • Threat Intelligence : поиск по домену WHOIS и геолокации IP

  • Метаданные и контроль исходного кода : список и просмотр сведений о репозитории

  • Аналитика ML : доступ к настройкам аналитики ML

  • Авторизация : Просмотр назначений ролей RBAC

  • Пользователи и группы Entra ID : просмотр сведений о пользователях и группах из Microsoft Entra ID

🚀 Быстрый старт

1. Аутентификация с помощью Azure CLI

Перед использованием сервера MCP необходимо пройти аутентификацию в Azure с учетной записью, имеющей доступ к рабочей области Microsoft Sentinel:

az login

2. Клонировать репозиторий

git clone https://github.com/dstreefkerk/ms-sentinel-mcp-server.git cd ms-sentinel-mcp-server

3. Установка с помощью скрипта PowerShell (рекомендуется)

Используйте предоставленный скрипт установки PowerShell для настройки сервера MCP:

# Run from the repository root directory .\install.ps1

Сценарий будет:

  • Проверьте установку Python

  • Создать виртуальную среду и установить зависимости

  • Создайте файл конфигурации Claude Desktop

  • Скопируйте конфигурацию в буфер обмена.

После запуска скрипта вы можете вставить конфигурацию непосредственно в ваш клиент MCP (Claude Desktop, Cursor и т. д.).

4. Используйте MCP-сервер

Сервер MCP будет готов к использованию после того, как вы настроите конфигурацию клиента MCP с соответствующей информацией о рабочем пространстве.

Просто помните, что если вы используете аутентификацию Azure CLI, вам необходимо удалить AZURE_CLIENT_ID и AZURE_CLIENT_SECRET из конфигурации клиента MCP.

🧰 Справочник инструментов

Ниже приведены доступные инструменты. Полную документацию см. в каталоге resources/tool_docs/ . Названия и описания инструментов синхронизируются с реестром инструментов сервера MCP, чтобы клиент MCP мог их извлечь.

Инструмент

Категория

Описание

entra_id_list_users

Входной идентификатор

Список всех пользователей в Microsoft Entra ID (Azure AD)

entra_id_get_user

Входной идентификатор

Получить пользователя по UPN или идентификатору объекта из Entra ID

entra_id_list_groups

Входной идентификатор

Список всех групп в Microsoft Entra ID (Azure AD)

entra_id_get_group

Входной идентификатор

Получить группу по идентификатору объекта из Entra ID

sentinel_logs_search

ККЛ

Выполнить запрос KQL к журналам Azure Monitor

sentinel_query_validate

ККЛ

Локальная проверка синтаксиса запроса KQL

sentinel_logs_search_with_dummy_data

ККЛ

Тестирование KQL-запроса с фиктивными данными

sentinel_logs_tables_list

Аналитика журналов

Список доступных таблиц в рабочей области Log Analytics

sentinel_logs_table_details_get

Аналитика журналов

Получить сведения о таблице Log Analytics

sentinel_logs_table_schema_get

Аналитика журналов

Получить схему для таблицы Log Analytics

sentinel_workspace_get

Аналитика журналов

Получить информацию о рабочем пространстве

sentinel_incident_details_get

Инциденты

Получите подробную информацию о конкретном инциденте Sentinel

sentinel_incident_list

Инциденты

Список инцидентов безопасности в Microsoft Sentinel

sentinel_analytics_rule_list

Правила аналитики

Перечислите все правила аналитики с ключевыми полями

sentinel_analytics_rule_get

Правила аналитики

Получите подробную информацию о конкретном правиле аналитики

sentinel_analytics_rules_count_by_tactic

Правила аналитики

Подсчет правил аналитики Sentinel по тактике

sentinel_analytics_rules_count_by_technique

Правила аналитики

Правила аналитики Count Sentinel по методике MITRE

sentinel_analytics_rule_templates_list

Шаблоны правил

Список всех шаблонов правил аналитики Sentinel

sentinel_analytics_rule_template_get

Шаблоны правил

Получите конкретный шаблон правила аналитики Sentinel

sentinel_analytics_rule_templates_count_by_tactic

Шаблоны правил

Шаблоны правил аналитики Count Sentinel по тактике

sentinel_analytics_rule_templates_count_by_technique

Шаблоны правил

Шаблоны правил аналитики Count Sentinel по методике MITRE

sentinel_hunting_queries_list

Охота

Список всех запросов Sentinel Hunting с дополнительной фильтрацией

sentinel_hunting_query_get

Охота

Получите полную информацию о запросе Sentinel по имени или идентификатору

sentinel_hunting_queries_count_by_tactic

Охота

Количество запросов на охоту Sentinel по тактике

sentinel_connectors_list

Коннекторы данных

Список соединителей данных

sentinel_connectors_get

Коннекторы данных

Получить конкретный коннектор данных по идентификатору

sentinel_watchlists_list

Списки наблюдения

Список всех списков наблюдения Sentinel

sentinel_watchlist_get

Списки наблюдения

Получить конкретный список наблюдения Sentinel

sentinel_watchlist_items_list

Списки наблюдения

Перечислите все элементы в списке наблюдения Sentinel

sentinel_watchlist_item_get

Списки наблюдения

Получить определенный элемент из списка наблюдения Sentinel

sentinel_domain_whois_get

Угрозы разведки

Получить информацию WHOIS для домена

sentinel_ip_geodata_get

Угрозы разведки

Получить данные геолокации для IP-адреса

sentinel_metadata_list

Метаданные

Список всех метаданных Sentinel в текущей рабочей области

sentinel_metadata_get

Метаданные

Получить сведения о конкретных метаданных Sentinel по идентификатору

sentinel_source_controls_list

Контроль исходного кода

Список всех элементов управления исходным кодом Sentinel в текущей рабочей области

sentinel_source_control_get

Контроль исходного кода

Получить сведения о конкретном элементе управления источником Sentinel по идентификатору

sentinel_ml_analytics_settings_list

Аналитика МО

Список всех настроек аналитики Sentinel ML

sentinel_ml_analytics_setting_get

Аналитика МО

Получить конкретную настройку аналитики Sentinel ML по имени

sentinel_authorization_summary

Авторизация

Обобщите назначения ролей Azure RBAC для доступа Sentinel

log_analytics_saved_searches_list

Сохраненные поиски

Список всех сохраненных поисков в рабочей области Log Analytics

log_analytics_saved_search_get

Сохраненные поиски

Получите определенный сохраненный поиск из рабочей области Log Analytics

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

Установка в Claude Desktop или аналогичные среды

Используйте предоставленный скрипт установки PowerShell для настройки сервера MCP для Claude Desktop или других клиентов, совместимых с MCP:

# Run from the repository root directory .\install.ps1

Сценарий будет:

  1. Проверьте установку Python

  2. Создать виртуальную среду и установить зависимости

  3. Выполнить шаги после установки

  4. Создайте файл конфигурации Claude Desktop

  5. Скопируйте конфигурацию в буфер обмена.

После запуска скрипта вы можете вставить конфигурацию непосредственно в ваш клиент MCP (Claude Desktop, Cursor и т. д.). Скрипт генерирует конфигурацию сервера MCP, совместимую с Claude. Помните об этом, если собираетесь использовать другой клиент MCP.

Расширенные параметры установки

Ручная настройка среды

Если вы предпочитаете настроить среду вручную:

  1. Настроить переменные среды

    Скопируйте предоставленный шаблон и заполните свои учетные данные Azure:

    cp .env.example .env # Edit .env and set: # AZURE_TENANT_ID, AZURE_CLIENT_ID, AZURE_CLIENT_SECRET, AZURE_SUBSCRIPTION_ID, AZURE_RESOURCE_GROUP, AZURE_WORKSPACE_NAME, AZURE_WORKSPACE_ID

  2. Установить зависимости (с uv)

    uv venv uv pip install -e .

  3. Альтернативные варианты запуска сервера

    Использование интерфейса командной строки MCP:

    mcp run wrapper.py

    Разработка и горячая перезагрузка:

    mcp dev wrapper.py

    Режим SSE (для IDE):

    python wrapper.py --sse

Пользовательский интерфейс инспектора

Пользовательский интерфейс MCP Inspector доступен по адресу http://127.0.0.1:6274 при работе в режиме разработки ( mcp dev wrapper.py ).

🧩 Развитие

  • Ресурсы: Добавьте файлы Python в resources/ и реализуйте функцию register_resources(mcp) .

  • Инструменты: Добавьте файлы Python в tools/ и реализуйте функцию register_tools(mcp) . Инструменты должны следовать структуре, определенной в docs/tool-architecture-and-implementation-requirements.md .

  • Подсказки: добавьте шаблоны подсказок в prompts/ для рабочих процессов, управляемых LLM.

Все компоненты в каталогах resources/ , tools/ и prompts/ автоматически обнаруживаются и регистрируются при запуске сервера. Ручной импорт не требуется.

🔐 Аутентификация и переменные среды

Сервер MCP поддерживает любой метод аутентификации, поддерживаемый DefaultAzureCredential из Azure Python SDK.

Аутентификация субъекта-службы вместо Azure CLI

Настройте регистрацию приложения в Azure и назначьте следующие роли:

  • Log Analytics Reader

  • Microsoft Sentinel Reader

Если вы чувствуете себя смелым, вы также можете предоставить регистрации приложения следующие разрешения Microsoft Graph:

  • User.Read.All

  • Group.Read.All

Затем используйте следующие переменные среды в файле .env или конфигурации сервера MCP:

  • AZURE_TENANT_ID

  • AZURE_CLIENT_ID

  • AZURE_CLIENT_SECRET

  • AZURE_SUBSCRIPTION_ID

  • AZURE_RESOURCE_GROUP

  • AZURE_WORKSPACE_NAME

  • AZURE_WORKSPACE_ID

Шаблон см. в .env.example .

Аутентификация Azure CLI

az login

Если вы используете аутентификацию Azure CLI, вы можете исключить AZURE_CLIENT_SECRET и AZURE_CLIENT_ID из конфигурации.

🐛 Отладка

Включите режим отладки, установив переменную среды MCP_DEBUG_LOG в true в файле .env :

MCP_DEBUG_LOG=true

Журналы записываются во временный каталог как sentinel_mcp_server.log .

📄 Лицензия

Данный проект лицензирован в соответствии с лицензией MIT .

This server cannot be installed

-
security - not tested
-
license - not tested
-
quality - not tested

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

ms-sentinel-mcp-сервер

  1. ⚠️ ВАЖНОЕ УВЕДОМЛЕНИЕ О БЕЗОПАСНОСТИ ⚠️
    1. ✨ Особенности
      1. 🚀 Быстрый старт
        1. 1. Аутентификация с помощью Azure CLI
        2. 2. Клонировать репозиторий
        3. 3. Установка с помощью скрипта PowerShell (рекомендуется)
        4. 4. Используйте MCP-сервер
      2. 🧰 Справочник инструментов
        1. 🛠️ Использование
          1. Установка в Claude Desktop или аналогичные среды
          2. Расширенные параметры установки
          3. Пользовательский интерфейс инспектора
        2. 🧩 Развитие
          1. 🔐 Аутентификация и переменные среды
            1. Аутентификация субъекта-службы вместо Azure CLI
            2. Аутентификация Azure CLI
          2. 🐛 Отладка
            1. 📄 Лицензия

              Related MCP Servers

              View all related MCP servers

              New MCP Servers

              MCP directory API

              We provide all the information about MCP servers via our MCP API.

              curl -X GET 'https://glama.ai/api/mcp/v1/servers/dstreefkerk/ms-sentinel-mcp-server'

              If you have feedback or need assistance with the MCP directory API, please join our Discord server