VirusTotal MCP Server
Servidor MCP de VirusTotal
Un servidor de Protocolo de Contexto de Modelo (MCP) para consultar la API de VirusTotal . Este servidor proporciona herramientas integrales de análisis de seguridad con obtención automática de datos de relaciones. Se integra a la perfección con aplicaciones compatibles con MCP, como Claude Desktop .
Inicio rápido (recomendado)
Instalación mediante herrería
Para instalar VirusTotal Server para Claude Desktop automáticamente a través de Smithery :
npx -y @smithery/cli install @burtthecoder/mcp-virustotal --client claudeInstalación manual
Instalar el servidor globalmente a través de npm:
npm install -g @burtthecoder/mcp-virustotalAgregue a su archivo de configuración de Claude Desktop:
{
"mcpServers": {
"virustotal": {
"command": "mcp-virustotal",
"env": {
"VIRUSTOTAL_API_KEY": "your-virustotal-api-key"
}
}
}
}Ubicación del archivo de configuración:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonVentanas:
%APPDATA%\Claude\claude_desktop_config.json
Reiniciar Claude Desktop
Related MCP server: OSINT MCP Server
Configuración alternativa (de la fuente)
Si prefiere ejecutar desde la fuente o necesita modificar el código:
Clonar y construir:
git clone <repository_url>
cd mcp-virustotal
npm install
npm run buildAñade a tu configuración de Claude Desktop:
{
"mcpServers": {
"virustotal": {
"command": "node",
"args": ["--experimental-modules", "/absolute/path/to/mcp-virustotal/build/index.js"],
"env": {
"VIRUSTOTAL_API_KEY": "your-virustotal-api-key"
}
}
}
}Características
Informes de análisis completos : cada herramienta de análisis obtiene automáticamente datos de relación relevantes junto con el informe básico, lo que proporciona una descripción general de seguridad completa en una sola solicitud.
Análisis de URL : informes de seguridad con obtención automática de dominios contactados, archivos descargados y actores de amenazas
Análisis de archivos : análisis detallado de hashes de archivos, incluidos comportamientos, archivos descartados y conexiones de red
Análisis de IP : informes de seguridad con datos históricos, resoluciones y amenazas relacionadas
Análisis de dominio : información DNS, datos WHOIS, certificados SSL y subdominios
Análisis detallado de relaciones : herramientas dedicadas para consultar tipos específicos de relaciones con soporte de paginación
Formato enriquecido : categorización y presentación claras de los resultados del análisis y los datos de relación
Herramientas
Herramientas de informes (con obtención automática de relaciones)
1. Herramienta de informes de URL
Nombre:
get_url_reportDescripción: Obtenga un informe completo de análisis de URL que incluye resultados de escaneo de seguridad y relaciones clave (archivos en comunicación, dominios/IP contactados, archivos descargados, redirecciones, actores de amenazas)
Parámetros:
url(obligatorio): La URL a analizar
2. Herramienta de informes de archivos
Nombre:
get_file_reportDescripción: Obtenga un informe completo de análisis de archivos utilizando su hash (MD5/SHA-1/SHA-256). Incluye resultados de detección, propiedades de archivo y relaciones clave (comportamientos, archivos eliminados, conexiones de red, contenido incrustado, actores de amenazas).
Parámetros:
hash(obligatorio): hash MD5, SHA-1 o SHA-256 del archivo
3. Herramienta de informes de IP
Nombre:
get_ip_reportDescripción: Obtenga un informe completo de análisis de direcciones IP que incluye geolocalización, datos de reputación y relaciones clave (archivos de comunicación, certificados históricos/WHOIS, resoluciones)
Parámetros:
ip(obligatorio): dirección IP a analizar
4. Herramienta de informes de dominio
Nombre:
get_domain_reportDescripción: Obtenga un informe de análisis de dominio completo que incluye registros DNS, datos WHOIS y relaciones clave (certificados SSL, subdominios, datos históricos)
Parámetros:
domain(obligatorio): Nombre de dominio a analizarrelationships(opcional): Matriz de relaciones específicas para incluir en el informe
Herramientas de relación (para un análisis detallado)
1. Herramienta de relación de URL
Nombre:
get_url_relationshipDescripción: Consulta un tipo de relación específico para una URL con compatibilidad con paginación. Elige entre 17 tipos de relación, incluyendo análisis, archivos en comunicación, dominios/IP contactados, archivos descargados, gráficos, referentes, redirecciones y actores de amenazas.
Parámetros:
url(obligatorio): La URL para obtener las relacionesrelationship(obligatorio): Tipo de relación a consultarRelaciones disponibles: análisis, comentarios, archivos_en_comunicación, dominios_contactados, IP_contactadas, archivos_descargados, gráficos, última_dirección_IP_de_servicio, ubicación_de_red, archivos_de_referencia, URL_de_referencia, URL_de_redireccionamiento, redirecciones_a, comentarios_relacionados, referencias_relacionadas, actores_de_amenaza_relacionados, envíos
limit(opcional, predeterminado: 10): número máximo de objetos relacionados para recuperar (1-40)cursor(opcional): Cursor de continuación para paginación
2. Herramienta de relación de archivos
Nombre:
get_file_relationshipDescripción: Consulta un tipo de relación específico para un archivo con compatibilidad con paginación. Elige entre 41 tipos de relación, incluyendo comportamientos, conexiones de red, archivos descartados, contenido incrustado, cadenas de ejecución y actores de amenazas.
Parámetros:
hash(obligatorio): hash MD5, SHA-1 o SHA-256 del archivorelationship(obligatorio): Tipo de relación a consultarRelaciones disponibles: análisis, comportamientos, archivos_agrupados, hijos_carbonblack, padres_carbonblack, archivos_agrupados_cifrados, padres_cifrados, pistas, colecciones, comentarios, padres_comprimidos, dominios_contactados, IPs_contactadas, URLs_contactadas, archivos_eliminados, adjuntos_de_correo_electrónico, padres_de_correo_electrónico, dominios_incrustados, IPs_incrustadas, URLs_incrustadas, padres_de_ejecución, gráficos, dominios_itw, IPs_itw, URLs_itw, dominios_patrón_memoria, IPs_patrón_memoria, URLs_patrón_memoria, hijos_superpuestos, padres_superpuestos, hijos_pcap, padres_pcap, hijos_recursos_pe, padres_recursos_pe, referencias_relacionadas, actores_de_amenaza relacionados, archivos_similares, envíos, capturas de pantalla, URLs_para_js_incrustados, votos
limit(opcional, predeterminado: 10): número máximo de objetos relacionados para recuperar (1-40)cursor(opcional): Cursor de continuación para paginación
3. Herramienta de relación de propiedad intelectual
Nombre:
get_ip_relationshipDescripción: Consulta un tipo de relación específico para una dirección IP con compatibilidad con paginación. Elige entre 12 tipos de relación, incluyendo archivos en comunicación, certificados SSL históricos, registros WHOIS, resoluciones y actores de amenazas.
Parámetros:
ip(obligatorio): dirección IP a analizarrelationship(obligatorio): Tipo de relación a consultarRelaciones disponibles: comentarios, archivos_comunicados, archivos_descargados, gráficos, certificados_ssl_históricos, whois_histórico, comentarios_relacionados, referencias_relacionadas, actores_de_amenaza_relacionados, archivos_de_referencia, resoluciones, URL
limit(opcional, predeterminado: 10): número máximo de objetos relacionados para recuperar (1-40)cursor(opcional): Cursor de continuación para paginación
4. Herramienta de relación de dominios
Nombre:
get_domain_relationshipDescripción: Consulta un tipo de relación específico para un dominio con compatibilidad con paginación. Elige entre 21 tipos de relación, incluyendo certificados SSL, subdominios, datos históricos y registros DNS.
Parámetros:
domain(obligatorio): Nombre de dominio a analizarrelationship(obligatorio): Tipo de relación a consultarRelaciones disponibles: registros_caa, registros_cname, comentarios, archivos_en_comunicación, archivos_descargados, certificados_ssl_históricos, whois_histórico, padre_inmediato, registros_mx, registros_ns, padre, archivos_de_referencia, comentarios_relacionados, referencias_relacionadas, actores_de_amenaza_relacionados, resoluciones, registros_soa, hermanos, subdominios, URL, votos_de_usuario
limit(opcional, predeterminado: 10): número máximo de objetos relacionados para recuperar (1-40)cursor(opcional): Cursor de continuación para paginación
Requisitos
Node.js (v18 o posterior)
Una clave API de VirusTotal válida
Solución de problemas
Problemas con la clave API
Si ve errores de "Clave API incorrecta":
Consulte el archivo de registro en
/tmp/mcp-virustotal-server.log(en macOS) para conocer el estado de la clave APIVerifique su clave API:
Debe ser una clave API de VirusTotal válida (normalmente 64 caracteres)
No se permiten espacios ni comillas adicionales alrededor de la clave
Debe ser de la sección Claves API en su cuenta de VirusTotal
Después de cualquier cambio de configuración:
Guardar el archivo de configuración
Reiniciar Claude Desktop
Consultar registros para conocer el estado de la nueva clave API
Problemas de carga del módulo
Si ve advertencias de carga del módulo ES:
Para la instalación global: utilice la configuración simple que se muestra en Inicio rápido
Para la instalación de origen: asegúrese de incluir
--experimental-modulesen los argumentos
Desarrollo
Para ejecutar en modo de desarrollo con recarga en caliente:
npm run devManejo de errores
El servidor incluye un manejo integral de errores para:
Claves API no válidas
Limitación de velocidad
Errores de red
Parámetros de entrada no válidos
Formatos hash no válidos
Formatos de IP no válidos
Formatos de URL no válidos
Tipos de relación no válidos
Errores de paginación
Historial de versiones
v1.0.0: Versión inicial con funcionalidad principal
v1.1.0: Se agregaron herramientas de análisis de relaciones para URL, archivos y direcciones IP
v1.2.0: Se agregó manejo y registro de errores mejorados
v1.3.0: Se agregó soporte de paginación para consultas de relación
v1.4.0: Se agregó la obtención automática de relaciones en las herramientas de informes y compatibilidad con análisis de dominios.
Contribuyendo
Bifurcar el repositorio
Crear una rama de características (
git checkout -b feature/amazing-feature)Confirme sus cambios (
git commit -m 'Add amazing feature')Empujar a la rama (
git push origin feature/amazing-feature)Abrir una solicitud de extracción
Licencia
Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.
Available Tools
11 toolsget_collectionA
Retrieve a VirusTotal collection by ID. Collections represent threat actors, malware families, campaigns, intel reports, and curated IOC sets — often referenced from the related_threat_actors and collections relationships on other tools. Optionally include relationships (files, urls, domains, ip_addresses, references, threat_actors, related_collections, related_references, comments, owner, autogenerated_graphs) to fetch member IOCs in the same call.
Inputs: id (required), relationships.
get_domain_relationshipA
Query a specific relationship type for a domain with pagination support. Choose from 24 relationship types including subdomains, resolutions, SSL certificates, WHOIS history, and threat actors. Useful for detailed investigation of specific relationship types.
Inputs: domain (required), relationship (required), limit, cursor.
get_domain_reportA
Get a comprehensive domain analysis report including DNS records, WHOIS data, and key relationships (SSL certificates, subdomains, historical data). Optionally specify which relationships to include in the report. Returns both the basic analysis and relationship data.
Inputs: domain (required), relationships.
get_file_behaviour_summaryA
Get a consolidated sandbox behaviour summary for a file (MD5/SHA-1/SHA-256), merged across every sandbox that analyzed it. Returns processes, files, registry, network activity, MITRE ATT&CK techniques, IDS alerts, and signature matches in a single view — far more useful than iterating individual behaviour reports.
Inputs: hash (required).
get_file_relationshipA
Query a specific relationship type for a file with pagination support. Choose from 40 relationship types including behaviors, network connections, dropped files, embedded content, execution chains, and threat actors. Useful for detailed investigation of specific relationship types.
Inputs: hash (required), relationship (required), limit, cursor.
get_file_reportA
Get a comprehensive file analysis report using its hash (MD5/SHA-1/SHA-256). Includes detection results, file properties, and key relationships (behaviors, dropped files, network connections, embedded content, threat actors). Returns both the basic analysis and automatically fetched relationship data.
Inputs: hash (required).
get_ip_relationshipB
Query a specific relationship type for an IP address with pagination support. Choose from 15 relationship types including communicating files, historical SSL certificates, WHOIS records, resolutions, and threat actors. Useful for detailed investigation of specific relationship types.
Inputs: ip (required), relationship (required), limit, cursor.
get_ip_reportA
Get a comprehensive IP address analysis report including geolocation, reputation data, and key relationships (communicating files, historical certificates/WHOIS, resolutions). Returns both the basic analysis and automatically fetched relationship data.
Inputs: ip (required).
get_url_relationshipA
Query a specific relationship type for a URL with pagination support. Choose from 22 relationship types including communicating files, contacted domains/IPs, downloaded files, redirects, referrers, threat actors, and collections. Useful for paging through the full list when the summary in get_url_report is truncated.
Inputs: url (required), relationship (required), limit, cursor.
get_url_reportA
Get a comprehensive URL analysis report including security scan results and key relationships (communicating files, contacted domains/IPs, downloaded files, redirects, threat actors). Returns the cached VirusTotal report when available, or submits the URL for scanning and waits for results.
Inputs: url (required).
search_vtA
Search the VirusTotal corpus for files, URLs, domains, IPs, or comments matching a query. Accepts plain IOCs (hash, URL, domain, IP), free text against comments, or VTI-style search modifiers like "type:peexe size:90kb+ tag:signed positives:5+". Paginated via cursor.
Inputs: query (required), limit, cursor.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Each tool targets a distinct resource and action: reports for comprehensive data, relationships for specific paginated queries, collection retrieval, and search. No two tools have overlapping purposes.
All tools follow a consistent verb_noun pattern in snake_case (e.g., get_domain_report, get_file_relationship, search_vt). The slight deviation for get_file_behaviour_summary is still clear and does not break consistency.
With 11 tools covering four entity types (domain, file, IP, URL) plus collection and search, the count is well-scoped for a read-oriented threat intelligence API—not too few, not excessive.
The set provides comprehensive coverage: for each entity there is a report and a relationship query, plus search and collection retrieval. Missing create/update/delete are expected for a read-only API; optional submission for URLs is handled.
Maintenance
Related MCP Connectors
Official VirusTotal MCP server: threat reports, file and URL submissions, and analysis recovery.
VirusTotal MCP — file / URL / domain / IP reputation (BYO key)
MCP server for ScanMalware.com URL scanning, malware detection, and analysis.
Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.
Related MCP Servers
FlicenseNot gradedqualityDmaintenanceMCP server that provides tools for interacting with the Fluidattacks API-- AlicenseDqualityDmaintenanceA comprehensive MCP server providing tools for IP, domain, email, and image-based open-source intelligence. It integrates services like Shodan, VirusTotal, and HaveIBeenPwned to facilitate advanced security research and data gathering.56MIT
- FlicenseAqualityDmaintenanceMCP server for security analysis using VirusTotal API, enabling AI assistants to analyze URLs, files, IP addresses, and domains with automatic relationship fetching.81-
- AlicenseCqualityDmaintenanceA Model Context Protocol (MCP) server that enables LLMs to interact with the VirusTotal API for malware analysis, URL scanning, and threat intelligence.81MIT