mcp-virustotal — VirusTotal для ИИ-агентов
mcp-virustotal
MCP-сервер к VirusTotal v3: агент проверяет хеш, URL, IP или домен и получает отчет с связями, как их разбирает аналитик
- 155 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Проверяемые индикаторы (хеши, URL, IP, домены) уходят во внешний сервис VirusTotal, а URL при промахе кэша отправляется на анализ
- Ключ API тратится на каждый запрос, HTTP-транспорт без авторизации позволяет чужим тратить квоту
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/mcp-virustotalОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Проверяемые индикаторы (хеши, URL, IP, домены) уходят во внешний сервис VirusTotal, а URL при промахе кэша отправляется на анализ
- Ключ API тратится на каждый запрос, HTTP-транспорт без авторизации позволяет чужим тратить квоту
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает агенту доступ к API VirusTotal v3. Передайте хеш, адрес, IP или домен и получите отчет об обнаружениях вместе со связями, по которым аналитик идет дальше: контактируемые хосты, сброшенные файлы, разрешения доменов, группировки угроз. Отчеты по файлам, URL, IP и доменам подтягивают основные связи одним пакетным запросом, чтобы экономить квоту. Инструментов одиннадцать. Четыре отчета (`get_file_report`, `get_url_report`, `get_ip_report`, `get_domain_report`), четыре постраничных обхода связей по каждому типу объекта (более сотни видов связей, курсор), а также `search_vt` с модификаторами в стиле VTI (`type:peexe positives:5+`), `get_file_behaviour_summary` для сводки поведения в песочницах и `get_collection` для групп угроз и семейств вредоносов. `get_url_report` сначала отдает кэшированный отчет и запускает новую проверку только при промахе. Сервер запускается по stdio для настольных клиентов и по HTTP-потоку для общего сервиса. Нужен Node.js 20 или новее и ваш ключ VirusTotal. Проект независимый и с VirusTotal и Google не связан.
Для кого. Аналитикам безопасности и SOC-командам, которые разбирают подозрительные файлы, адреса и домены и хотят задавать вопросы к VirusTotal прямо из ассистента.
Подходит, если
- В письме подозрительная ссылка, и нужен отчет с обнаружениями и контактируемыми хостами
- У вас хеш вредоносного образца и надо понять, какие файлы он сбрасывает и к чему обращается
- Требуется найти в корпусе файлы по условиям вроде типа и числа детектов
- Нужно собрать сводку поведения образца в песочницах и связать ее с группировкой угроз
Не подходит, если
- Вам нужно заблокировать или удалить вредоносное: сервер только читает данные VirusTotal
- Нет ключа VirusTotal: без него не работает ни один инструмент
- Нужен автономный анализ без внешних сервисов: сервер работает только через VirusTotal
Пример запроса к агенту
Проверь SHA-256 275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f в VirusTotal и покажи, что этот файл сбрасывает и к каким адресам обращается.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
VIRUSTOTAL_API_KEYобязательная, секрет- Ключ API VirusTotal v3, 64 символа без пробелов и кавычек.
MCP_TRANSPORT- stdio по умолчанию или httpStream для общего сервиса.
Ограничения
Нужен личный ключ VirusTotal. Публичный бесплатный уровень допускает 4 запроса в минуту, при превышении приходит ошибка 429.
HTTP-транспорт (`MCP_TRANSPORT=httpStream`) не имеет авторизации: держите порт на localhost или за прокси с проверкой, иначе любой желающий потратит вашу квоту. Проект независимый, а пакет опубликован под именем `@burtthecoder/mcp-virustotal`, отличающимся от имени репозитория.
Как отключить. Удалите сервер командой `claude mcp remove virustotal` и отзовите ключ в личном кабинете VirusTotal.
Частые вопросы
Как подключить mcp-virustotal к Claude Code, Codex или Gemini CLI?
Каждому клиенту своя команда с ключом в переменной `VIRUSTOTAL_API_KEY` и запуском через `npx -y @burtthecoder/mcp-virustotal`: `claude mcp add`, `codex mcp add` и `gemini mcp add`. Настройки для Claude Desktop и VS Code лежат в docs/clients.md.
Связан ли проект с VirusTotal или Google?
Нет, автор пишет, что проект независимый и ни с VirusTotal, ни с Google не связан. Нужен ваш собственный ключ API VirusTotal.
Как найти в корпусе файлы по условию?
Через `search_vt` с модификаторами в стиле VTI, например `type:peexe positives:5+`. Результаты можно связать с поведением в песочницах (`get_file_behaviour_summary`) и группами угроз (`get_collection`).
Какой ключ нужен и какой у него лимит?
Нужен ваш ключ API VirusTotal (на странице my-apikey). Бесплатный публичный уровень допускает 4 запроса в минуту, при превышении приходит ошибка 429. Ключ передают в `VIRUSTOTAL_API_KEY`, и он отправляется только в VirusTotal.
Можно ли запустить сервер как общий сервис?
Да, режим `MCP_TRANSPORT=httpStream` запускает HTTP-сервис на порту `MCP_PORT`, есть образ Docker и проверка `/health`. Авторизации у этого транспорта нет: держите порт на localhost или за прокси с проверкой, иначе любой желающий потратит ваш лимит.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыVirusTotal MCP — проверка файлов и ссылок в агенте
VirusTotal MCP
Официальный MCP-сервер VirusTotal: агент проверяет файлы, ссылки, домены и IP по отчетам VTAI и по запросу отправляет их на анализ
MCP-сервер, который дает агенту разбор уязвимостей: данные NVD, EPSS, каталог CISA KEV, связки с MITRE ATT&CK и оценка риска CVE в одном запросе
cvENGINE находит внешние активы домена и уязвимости, которые уже эксплуатируют, а MCP-сервер ведет сканы из Claude Code
Инструмент анализа вредоносных файлов с MCP-сервером: агент вызывает разбор файлов, документов и архивов, поиск индикаторов и проверку подписей
Сканер безопасности для MCP-серверов: ищет зашитые ключи, отравление инструментов и инъекции в коде репозитория.
Бесплатный MCP-сервер уязвимостей: CVE, GHSA, OSV, CISA KEV и EPSS в одной записи, плюс проверка файла зависимостей проекта.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| mcp-virustotal — VirusTotal для ИИ-агентов (эта карточка) | нет | API-ключ | 155 | |
| Threat Modeling MCP Server | да | не нужна | 126 | моделирование угроз для архитектуры, без разбора индикаторов |
| claude-osint | нет | 3 017 | разведка по открытым источникам без отчетов VirusTotal |
Коротко о README
В README изложены назначение сервера, возможности (отчеты со связями, кэш в первую очередь, инструменты разворота, постраничные связи и два транспорта), быстрый старт для трех клиентов, список из одиннадцати инструментов, настройку HTTP и переменные окружения, предупреждение о безопасности и разбор типовых ошибок.