BurtTheCoder/mcp-virustotal

BurtTheCoder/mcp-virustotal

от burtthecoder
MCP сервер для VirusTotal: проверяет безопасность URL, файлов и IP-адресов (включая домены), автоматически собирая связанные данные. Включает поиск по корпусу, сводки поведения и коллекции угроз. Помогает аналитикам ИБ быстро исследовать угрозы через Claude Desktop.

mcp-virustotal: threat intelligence for AI agents

npm version CI License: MIT Node 20 or newer MCP Registry Smithery

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.

Заметка

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.

Часто задаваемые вопросы

Инструменты были проиндексированы:
get_collection

Получает коллекцию VirusTotal по идентификатору. Коллекции — это угрозы, семьи вредоносных программ, кампании, разведданные и подобранные наборы IOC. На них часто ссылаются из связей related_threat_actors и collections других инструментов. Опционально включает связи (files, urls, domains, ip_addresses, references, threat_actors, related_collections, related_references, comments, owner, autogenerated_graphs), чтобы получить входящие в коллекцию IOC в том же вызове.

Параметры
  • idstringобязательный

    Идентификатор коллекции (например, идентификатор субъекта угрозы, семейства вредоносных программ, кампании или отчета, возвращаемый при поиске связей)

  • relationshipsenum[]

    Необязательный список связей для включения в ответ.

get_domain_relationship

Запрашивает определённый тип отношений для домена с поддержкой пагинации. Выбирает из 24 типов отношений, включая поддомены, разрешения, SSL-сертификаты, историю WHOIS и угрозы. Полезен для детального исследования конкретных типов отношений.

Параметры
  • cursorstring
  • domainstringобязательный

    Доменное имя для анализа

  • limitnumber
  • relationshipenumобязательный

    Тип отношения для запроса

get_domain_report

Получает комплексный отчёт по анализу домена, включающий DNS-записи, WHOIS-данные и ключевые связи (SSL-сертификаты, поддомены, исторические данные). Опционально можно указать, какие именно связи включить в отчёт. Возвращает и базовый анализ, и данные о связях.

Параметры
  • domainstringобязательный

    Доменное имя для анализа

  • relationshipsenum[]

    Необязательный массив связей для включения в отчёт.

get_file_behaviour_summary

Получает сводку поведения песочницы для файла (MD5/SHA-1/SHA-256), объединённую по всем песочницам, которые его анализировали. Возвращает процессы, файлы, реестр, сетевую активность, техники MITRE ATT&CK, срабатывания IDS и сигнатуры в одном представлении: это гораздо полезнее, чем просматривать отдельные отчёты о поведении.

Параметры
  • hashstringобязательный

    MD5, SHA-1 или SHA-256 хэш файла

get_file_relationship

Запрашивает определённый тип связи для файла с поддержкой пагинации. Выбирает из 40 типов связей, включая поведение, сетевые подключения, сброшенные файлы, встроенный контент, цепочки выполнения и субъекты угроз. Полезен для детального исследования конкретных типов связей.

Параметры
  • cursorstring
  • hashstringобязательный

    MD5, SHA-1 или SHA-256 хэш файла

  • limitnumber
  • relationshipenumобязательный

    Тип отношения для запроса

get_file_report

Получает полный отчет анализа файла по его хешу (MD5/SHA-1/SHA-256). Включает результаты обнаружения, свойства файла и ключевые взаимосвязи (поведение, сброшенные файлы, сетевые подключения, встроенное содержимое, субъекты угроз). Возвращает как базовый анализ, так и автоматически полученные данные о взаимосвязях.

Параметры
  • hashstringобязательный

    MD5, SHA-1 или SHA-256 хэш файла

get_ip_relationship

Запрашивает определенный тип связи для IP-адреса с поддержкой пагинации. Выберите из 15 типов связей, включая взаимодействующие файлы, исторические SSL-сертификаты, записи WHOIS, разрешения и субъекты угроз. Полезен для детального исследования конкретных типов связей.

Параметры
  • cursorstring
  • ipanyобязательный

    Анализируемый IP-адрес

  • limitnumber
  • relationshipenumобязательный

    Тип отношения для запроса

get_ip_report

Получает подробный отчёт об анализе IP-адреса, включающий геолокацию, данные о репутации и ключевые связи (взаимодействующие файлы, исторические сертификаты/WHOIS, разрешения). Возвращает как базовый анализ, так и автоматически полученные данные о связях.

Параметры
  • ipanyобязательный

    Анализируемый IP-адрес

get_url_relationship

Запрашивает определённый тип отношений для URL с поддержкой пагинации. Выбирает из 22 типов отношений, включая обменивающиеся файлы, контактировавшие домены/IP-адреса, загруженные файлы, перенаправления, рефереры, субъекты угроз и коллекции. Полезен для пролистывания полного списка, когда сводка в get_url_report не даёт всей картины.

Параметры
  • cursorstring
  • limitnumber
  • relationshipenumобязательный

    Тип отношения для запроса

  • urlstringобязательный

    URL для получения связей

get_url_report

Получает комплексный отчет анализа URL, включающий результаты сканирования безопасности и ключевые связи (взаимодействующие файлы, запрошенные домены/IP-адреса, скачанные файлы, перенаправления, угрозы). Возвращает кэшированный отчет VirusTotal, если он доступен, или отправляет URL на сканирование и ждет результатов.

Параметры
  • urlstringобязательный

    URL для анализа

search_vt

Ищет в корпусе VirusTotal файлы, URL, домены, IP-адреса или комментарии, соответствующие запросу. Принимает простые IOC (хеш, URL, домен, IP), произвольный текст для поиска по комментариям или модификаторы поиска в стиле VTI, например "type:peexe size:90kb+ tag:signed positives:5+". Разбивает результаты на страницы через курсор.

Параметры
  • cursorstring
  • limitnumber
  • querystringобязательный

    Поисковый запрос. Принимает хеши файлов, URL-адреса, домены, IP-адреса, комментарии или модификаторы поиска в стиле VTI (например, "type:peexe size:90kb+ tag:signed").

1.0.35основная
1.0.34
1.0.33
1.0.32
1.0.31
1.0.30
1.0.29
1.0.28
1.0.25
1.0.24
1.0.23
1.0.22
1.0.21
1.0.20
1.0.19
1.0.18
1.0.17
1.0.16
1.0.10
1.0.9
1.0.8
1.0.7
1.0.6
1.0.5
1.0.4
1.0.3
1.0.2
1.0.1
1.0.0

Выберите клиент, чтобы установить BurtTheCoder/mcp-virustotal:

Любой клиент

Конфиг добавления MCP сервера стандартный, обычно он не меняется вообще, поэтому подходит практически к любому ИИ клиенту, поддерживающему MCP.

{
  "mcpServers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}
CursorCursor

Перейдите по ссылке и сервер автоматически будет добавлен в Cursor. Либо откройте/создайте файл ~/.cursor/mcp.json(%USERPROFILE%\.cursor\mcp.json на Windows) и добавьте конфиг сервера:

{
  "mcpServers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}
VS Code

Создайте .vscode/mcp.json в проекте (ключ верхнего уровня — servers):

{
  "servers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}

Либо добавьте сервер через терминал:

code --add-mcp "{\"name\":\"burtthecoder-mcp-virustotal-kdt428qrbh\",\"type\":\"stdio\",\"command\":\"npx\",\"args\":[\"-y\",\"@burtthecoder/mcp-virustotal\"],\"env\":{\"VIRUSTOTAL_API_KEY\":\"your-key\"}}"
ClaudeClaude Desktop

Откройте Settings → Developer → Edit Config — это откроет файл claude_desktop_config.json:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json

Впишите сервер и полностью перезапустите Claude Desktop:

{
  "mcpServers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}
Claude CodeClaude Code

Добавьте сервер одной командой в терминале:

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

Либо через JSON-конфиг:

claude mcp add-json burtthecoder-mcp-virustotal-kdt428qrbh "{\"command\":\"npx\",\"args\":[\"-y\",\"@burtthecoder/mcp-virustotal\"],\"env\":{\"VIRUSTOTAL_API_KEY\":\"your-key\"}}"
CodexCodex

Добавьте сервер командой в терминале:

codex mcp add burtthecoder-mcp-virustotal-kdt428qrbh --env VIRUSTOTAL_API_KEY=your-key -- npx -y @burtthecoder/mcp-virustotal

Либо вручную в ~/.codex/config.toml(%USERPROFILE%\.codex\config.toml на Windows):

[mcp_servers.burtthecoder-mcp-virustotal-kdt428qrbh]
command = "npx"
args = ["-y", "@burtthecoder/mcp-virustotal"]

[mcp_servers.burtthecoder-mcp-virustotal-kdt428qrbh.env]
VIRUSTOTAL_API_KEY = "your-key"
PerplexityPerplexity

MCP доступен подписчикам Perplexity Pro / Max / Enterprise. Локальные серверы — только в приложении для macOS.

  1. Откройте Настройки аккаунта → Connectors.
  2. Установите вспомогательное приложение PerplexityXPC (один раз).
  3. Нажмите Add Connector → вкладка Simple.
  4. В поле Server Name укажите BurtTheCoder/mcp-virustotal, а в поле команды запуска — строку ниже:
npx -y @burtthecoder/mcp-virustotal

Нажмите Save и дождитесь статуса Running.

WindsurfWindsurf

Откройте Windsurf Settings → Cascade → MCP Servers или отредактируйте файл ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}
ClineCline

В панели Cline нажмите иконку MCP Servers → Configure → Configure MCP Servers (или отредактируйте ~/.cline/mcp.json) и добавьте сервер:

{
  "mcpServers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}
Continue

Создайте файл в .continue/mcpServers/ (например burtthecoder-mcp-virustotal-kdt428qrbh.yaml) или добавьте блок в config.yaml. MCP работает только в режиме agent:

mcpServers:
  - name: burtthecoder-mcp-virustotal-kdt428qrbh
    command: npx
    args:
      - "-y"
      - "@burtthecoder/mcp-virustotal"
    env:
      VIRUSTOTAL_API_KEY: your-key
Zed

Выполните agent: add context server или откройте настройки (zed: open settings file) и добавьте сервер в объект context_servers:

{
  "context_servers": {
    "burtthecoder-mcp-virustotal-kdt428qrbh": {
      "command": "npx",
      "args": [
        "-y",
        "@burtthecoder/mcp-virustotal"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your-key"
      }
    }
  }
}

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

urldna/mcp

urldna/mcp

от urldna

urlDNA MCP Server подключает LLM-агентов к платформе urlDNA для анализа URL на угрозы. Поддерживает быструю проверку, сканирование, поиск по CQL и мониторинг брендов. Идеален для security-аналитико...

Python⭐ 7
ppcvote/misp-mcp-server

ppcvote/misp-mcp-server

от ppcvote

MCP сервер для безопасного доступа LLM-агентов к платформе MISP. С защитой от prompt-инъекций и read-only. 8 инструментов для поиска событий, атрибутов и тегов. Для аналитиков ИБ и threat intel команд.

TypeScript⭐ 2
honeylabshq/honeylabs-mcp

honeylabshq/honeylabs-mcp

официальный

от honeylabshq

MCP сервер для доступа к данным honeypot-сети HoneyLabs за 90 дней: репутация IP, классификация сканеров и TLS/SSH отпечатки. Полезен SOC-аналитикам для расследования угроз из Claude, Cursor и других MCP клиентов.

Python⭐ 2
alberthild/shieldapi-mcp

alberthild/shieldapi-mcp

от alberthild

MCP-сервер для безопасности AI-агентов: детекция промпт-инъекций, сканирование навыков на уязвимости цепочки поставок, проверка URL, паролей, email и IP. Бесплатно 10 вызовов в день без регистрации...

JavaScript⭐ 1
fr0gger/MCP_Security

fr0gger/MCP_Security

от fr0gger

MCP сервер для поиска и анализа угроз через API ORKL. Предоставляет инструменты для детального просмотра отчётов, threat actors и источников. Полезен специалистам по кибербезопасности для быстрого доступа к данным разведки угроз.

Python⭐ 52
gridinsoft/mcp-inspector

gridinsoft/mcp-inspector

от gridinsoft

MCP сервер для анализа безопасности доменов и URL через базу GridinSoft. Помогает ИИ-агентам проверять репутацию сайтов, выявлять фишинг и вредоносное ПО. Подходит разработчикам и специалистам по б...

JavaScript⭐ 1
© Каталог MCP, 2026. Все права защищены.
Проект не аффилирован с Anthropic и любыми упомянутыми продуктами.
Все названия и торговые марки принадлежат их владельцам.
Контакты для связи: hi@mcp-katalog.ru

Лука Никитин