Sophos Central MCP (только чтение)

Неофициальный MCP-сервер, предоставляющий информацию из Sophos Central только для чтения: состояние антивируса/конечных точек, инвентаризация и статус межсетевых экранов, настройки коммутаторов и защита электронной почты (карантин, почтовые ящики, статус отзыва). Создан на основе публичных API Sophos Central с использованием собственной коллекции Postman от вендора в качестве источника истины для путей, заголовков и форм ответов.

Не связан с Sophos, не одобрен и не спонсируется Sophos.

Область применения: только чтение, по замыслу

Этот сервер не реализует вообще никаких изменяющих конечных точек — ни за флагом, ни за списком запрета, они просто не подключены. Намеренно исключены:

• Конечные точки: изоляция/снятие изоляции, изменения защиты от несанкционированного доступа, CRUD политик, сканирования, криминалистические журналы/дампа памяти, CRUD групп конечных точек, миграции.

• Межсетевые экраны: обновления прошивки, перезагрузка/другие действия с межсетевыми экранами, CRUD групп межсетевых экранов, запись индикаторов MDR-канала угроз.

• Коммутаторы: запись в список MAC-фильтров.

• Электронная почта: освобождение или удаление из карантина/карантина после доставки, инициирование отзыва, создание/обновление/удаление/массовые операции с почтовыми ящиками, запись владельцев псевдонимов/делегатов/списков рассылки, удаление/повторное прикрепление/загрузка вложений.

Если вам нужны какие-либо из них, они задокументированы в API Sophos, но не реализованы здесь — создайте issue или добавьте инструмент, следуя тому же шаблону в src/tools.ts.

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

Sophos Central использует OAuth2 с учетными данными клиента. Создайте учетные данные API в Sophos Central в разделе Settings > API Credential Management, что даст вам идентификатор клиента и секрет клиента, ограниченные одним арендатором (или учетной записью организации/партнера, управляющей несколькими арендаторами).

SOPHOS_CLIENT_ID=...
SOPHOS_CLIENT_SECRET=...

Сервер обменивает их на токен доступа (https://id.sophos.com/api/v2/oauth2/token), определяет идентификатор арендатора вызывающего абонента и хост API региона данных через whoami и отправляет X-Tenant-ID (или X-Organization-ID/X-Partner-ID для этих типов учетных данных) в каждом последующем запросе. Никакой идентификатор арендатора не нужно настраивать вручную.

Установка

npm ci && npm run build

Затем укажите вашему MCP-клиенту на dist/entry.js:

{
  "mcpServers": {
    "sophos-central": {
      "command": "node",
      "args": ["/path/to/sophos-central-mcp/dist/entry.js"],
      "env": {
        "SOPHOS_CLIENT_ID": "...",
        "SOPHOS_CLIENT_SECRET": "..."
      }
    }
  }
}

Инструменты

Примечания к собственной поверхности API Sophos

• API коммутаторов в настоящее время узок. Собственные примеры Postman от вендора охватывают только настройки MAC-фильтров и статус асинхронных задач — отдельная конечная точка инвентаризации устройств коммутатора на данный момент не задокументирована.

• Восстановление конечных точек/просмотр файлов и журналы трафика межсетевых экранов вообще не охватываются этой поверхностью API; для этого остается использовать консоль Sophos Central.