w0h1v/mcp-virustotal

Быстрый старт · Инструменты · HTTP · Безопасность · Устранение неполадок · Документы

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

[! ПРИМЕЧАНИЕ] Независимый проект, не связанный с VirusTotal или Google. Вам нужен собственный ключ API VirusTotal.

Основные моменты

• Отчёты с отношениями. Файлы, URL, IP и доменные отчёты выбирают связи ключей в одном пакетном [?relationships= вызове для сохранения квоты.
• Сначала кэшировать. get_url_report возвращает кэшированный отчёт VirusTotal и отправляет скан только при промахе кэша.
• Pivot tools. Поиск по корпусу с модификаторами в стиле VTI (type:peexe positives:5+), объединёнными сводками поведения песочницы, а также коллекциями злоумышленников и семейств вредоносных программ.
• Полная пейджинг отношений. 100+ типов отношений между файлами, URL-адресами, IP-адресами и доменами с помощью пагинации курсора.
• Два транспорта. stdio для настольных клиентов, HTTP-поток для общего сервиса.
• Протестировано. Модульные тесты для форматировок и API выполняются в CI на узлах 20, 22 и 24.

Quickstart · Tools · HTTP · Security · Troubleshooting · Docs

mcp-virustotal is an MCP server that gives AI agents access to the VirusTotal v3 API. Hand your agent a hash, URL, IP or domain and get back the detection report plus the relationships an analyst would pivot on: contacted hosts, dropped files, resolutions, threat actors.

[!NOTE] Independent project, not affiliated with VirusTotal or Google. You need your own VirusTotal API key.

Highlights

• Reports with relationships. File, URL, IP and domain reports fetch key relationships in one batched ?relationships= call to save quota.
• Cache first. get_url_report returns the cached VirusTotal report and only submits a scan on a cache miss.
• Pivot tools. Corpus search with VTI-style modifiers (type:peexe positives:5+), merged sandbox behaviour summaries, and threat-actor and malware-family collections.
• Full relationship paging. 100+ relationship types across files, URLs, IPs and domains, with cursor pagination.
• Two transports. stdio for desktop clients, HTTP streaming for a shared service.
• Tested. Unit tests for the formatters and API layer run in CI on Node 20, 22 and 24.

How it works

flowchart LR
    A["AI agent(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-virustotal"]
    S -->|"validate input,HTTPS + API key"| V["VirusTotal v3 API"]
    V -->|"JSON"| S
    S -->|"formatted report text"| A

Quickstart