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-режим без авторизации.
Настройка клиентов
{
"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.
puter
Работа с Puter: управление файлами, сайтами, воркерами и другими ресурсами.
filesystem
Сервер из UI-TARS-desktop для доступа к файловой системе.
Handsy AI
Управление настоящим iPhone через USB HID на ESP32-S3 и AirPlay без джейлбрейка.