mcp-virustotal

mcp-virustotal — MCP-сервер сообщества (автор — w0h1v). Запросы к VirusTotal API для анализа безопасности. Ставится через Docker. Лицензия MIT.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
w0h1v
Лицензия
MIT
Транспорт
stdio
Авторизация
api_key
ОС
Не указана
Языки
typescript

Уровень риска: medium

Отправляет индикаторы в VirusTotal и расходует квоту ключа API; HTTP-режим без авторизации.

Настройка клиентов

codex
{
    "code": "codex mcp add virustotal --env VIRUSTOTAL_API_KEY=your-key -- npx -y @burtthecoder/mcp-virustotal",
    "lang": "bash",
    "notes": "Подставьте ключ",
    "verified": "docs"
}

Что умеет

mcp-virustotal — MCP-сервер, который даёт ИИ-агентам доступ к API VirusTotal v3. Передайте агенту хэш файла, URL, IP-адрес или домен — он вернёт отчёт об обнаружениях и связи, по которым аналитик продолжил бы расследование: что файл сбрасывает, с какими адресами связывается, какие домены связаны с IP. Это независимый проект, не связанный с VirusTotal и Google; нужен собственный ключ API VirusTotal.

Одиннадцать инструментов в трёх группах:

  • Отчёты со связями — get_file_report, get_url_report, get_ip_report, get_domain_report. Ключевые связи запрашиваются одним пакетным вызовом, чтобы экономить квоту.
  • Постраничный обход связей — get_file_relationship, get_url_relationship, get_ip_relationship, get_domain_relationship: более 100 типов связей для файлов, URL, IP и доменов с курсорной пагинацией.
  • Поиск и переходы — search_vt (поиск по корпусу с модификаторами в стиле VTI, например по типу файла и числу срабатываний), get_file_behaviour_summary (объединённая сводка поведения в песочницах), get_collection (коллекции по группировкам злоумышленников и семействам вредоносного ПО).

Особенности: get_url_report сначала возвращает кэшированный отчёт VirusTotal и отправляет URL на сканирование только при промахе кэша. Аргументы проверяются схемами до отправки запроса. Есть два транспорта: stdio для настольных клиентов и HTTP-стриминг для общего сервиса.

Кому подойдёт

  • Аналитикам SOC и специалистам по реагированию, проверяющим индикаторы компрометации в диалоге с ИИ.
  • Исследователям вредоносного ПО: поведение в песочнице, связи и коллекции.
  • ИБ-инженерам, автоматизирующим первичный разбор подозрительных файлов и ссылок.

Похожие серверы — в категории безопасность.

Установка

Нужны Node.js 20+ и ключ API VirusTotal, который передаётся в переменной VIRUSTOTAL_API_KEY. Сервер запускается через npx -y @burtthecoder/mcp-virustotal. Для HTTP-режима задайте MCP_TRANSPORT=httpStream и при необходимости MCP_PORT; есть Dockerfile, проверка работоспособности доступна по адресу /health. Инструкции для Claude Desktop и VS Code — в документации проекта.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

claude mcp add --transport stdio --env VIRUSTOTAL_API_KEY=your-key virustotal -- npx -y @burtthecoder/mcp-virustotal

Замените your-key своим ключом — обычно это 64 символа без пробелов и кавычек. После смены конфигурации перезапустите клиент.

Проверка

README предлагает спросить агента о SHA-256 тестового файла EICAR и попросить показать, что он сбрасывает и с чем связывается.

Примеры задач

Проверь домен example-login.com: репутация, связанные IP и файлы, которые с ним связывались.
Найди в VirusTotal исполняемые файлы с пятью и более срабатываниями, похожие на этот хэш, и опиши их поведение.

Риски

  • Передача индикаторов. Хэши, URL, IP и домены отправляются в VirusTotal; URL при промахе кэша отправляется на анализ — не проверяйте так внутренние или секретные ссылки.
  • Ключ и квота. Ключ читается из окружения и отправляется только в VirusTotal. Публичный тариф допускает 4 запроса в минуту.
  • HTTP-режим без авторизации. Держите порт на localhost или за обратным прокси с аутентификацией, иначе любой, кто до него достучится, потратит вашу квоту.

Частые вопросы

Это официальный сервер VirusTotal?

Нет, это независимый проект, не связанный с VirusTotal и Google.

Почему возникают ошибки 429?

Публичный тариф VirusTotal разрешает 4 запроса в минуту.

Сканирует ли сервер URL заново?

Только если в кэше VirusTotal нет отчёта по этому адресу.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

markitdown-mcp

Конвертация файлов разных форматов, локальных и по ссылке, в Markdown для моделей с помощью MarkItDown.

Риск: medium Лицензия: MIT ★ 196 722

puter

Работа с Puter: управление файлами, сайтами, воркерами и другими ресурсами.

Риск: medium Лицензия: AGPL-3.0 ★ 44 148

filesystem

Сервер из UI-TARS-desktop для доступа к файловой системе.

Риск: high Лицензия: Apache-2.0 ★ 39 555

Handsy AI

Управление настоящим iPhone через USB HID на ESP32-S3 и AirPlay без джейлбрейка.

Риск: high Лицензия: MIT ★ 4 888

Источники