VirusTotal MCP 服务器

用于查询VirusTotal API 的模型上下文协议 (MCP) 服务器。该服务器提供全面的安全分析工具，并可自动获取关系数据。它与Claude Desktop等兼容 MCP 的应用程序无缝集成。

快速入门（待定）

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 virustotal-mcp：

手动安装

待定

特征

• 综合分析报告：每个分析工具都会自动获取相关关系数据以及基本报告，在单个请求中提供完整的安全概述

• URL 分析：自动获取联系域、下载文件和威胁行为者的安全报告

• 文件分析：详细分析文件哈希，包括行为、丢失的文件和网络连接

• IP 分析：包含历史数据、解决方案和相关威胁的安全报告

• 域名分析：DNS 信息、WHOIS 数据、SSL 证书和子域名

• 详细关系分析：用于查询特定类型关系的专用工具，并支持分页

• 高级搜索：VT Intelligence 搜索功能，可针对 VirusTotal 数据集中的复杂查询

• 丰富的格式：分析结果和关系数据的清晰分类和呈现

工具

报告工具（具有自动关系获取功能）

1. URL 报告工具

• 名称： get_url_report

• 描述：获取全面的 URL 分析报告，包括安全扫描结果和关键关系（通信文件、联系的域/IP、下载的文件、重定向、威胁行为者）

• 参数：

  • url （必填）：需要分析的 URL

• 例子：

2. 文件报告工具

• 名称： get_file_report

• 描述：使用哈希值 (MD5/SHA-1/SHA-256) 获取全面的文件分析报告。包含检测结果、文件属性和关键关系（行为、丢失的文件、网络连接、嵌入内容、威胁行为者）。

• 参数：

  • hash （必需）：文件的 MD5、SHA-1 或 SHA-256 哈希值

• 例子：

3. IP报告工具

• 名称： get_ip_report

• 描述：获取全面的 IP 地址分析报告，包括地理位置、信誉数据和关键关系（通信文件、历史证书/WHOIS、解析）

• 参数：

  • ip （必填）：需要分析的IP地址

• 例子：

4. 域名报告工具

• 名称： get_domain_report

• 描述：获取全面的域名分析报告，包括 DNS 记录、WHOIS 数据和关键关系（SSL 证书、子域名、历史数据）

• 参数：

  • domain （必需）：要分析的域名

• 例子：

关系工具（用于详细分析）

1. URL关系工具

• 名称： get_url_relationship

• 描述：查询具有分页支持的 URL 的特定关系类型

• 参数：

  • url （必填）：获取关系的 URL

  • relationship （必需）：要查询的关系类型

    • 可用关系：分析、评论、communicating_files、contacted_domains、contacted_ips、downloaded_files、图表、last_serving_ip_address、network_location、referrer_files、referrer_urls、redirecting_urls、redirects_to、related_comments、related_references、related_threat_actors、提交

  • limit （可选，默认值：10）：要检索的最大相关对象数（1-40）

  • cursor （可选）：用于分页的连续光标

• 例子：

2. 文件关系工具

• 名称： get_file_relationship

• 描述：查询文件的特定关系类型，支持分页

• 参数：

  • hash （必需）：文件的 MD5、SHA-1 或 SHA-256 哈希值

  • relationship （必需）：要查询的关系类型

    • 可用的关系：分析、行为、bundled_files、carbonblack_children、carbonblack_parents、ciphered_bundled_files、ciphered_parents、线索、集合、评论、compressed_parents、contacted_domains、contacted_ips、contacted_urls、dropped_files、email_attachments、email_parents、embedded_domains、embedded_ips、embedded_urls、execution_parents、图表、itw_domains、itw_ips、itw_urls、memory_pattern_domains、memory_pattern_ips、memory_pattern_urls、overlay_children、overlay_parents、pcap_children、pcap_parents、pe_resource_children、pe_resource_parents、related_references、related_threat_actors、similar_files、提交、屏幕截图、urls_for_embedded_js、投票

  • limit （可选，默认值：10）：要检索的最大相关对象数（1-40）

  • cursor （可选）：用于分页的连续光标

• 例子：

3. IP关系工具

• 名称： get_ip_relationship

• 描述：查询特定关系类型的 IP 地址，支持分页

• 参数：

  • ip （必填）：需要分析的IP地址

  • relationship （必需）：要查询的关系类型

    • 可用关系：comments、communicating_files、downloaded_files、graphs、historical_ssl_certificates、historical_whois、related_comments、related_references、related_threat_actors、referrer_files、resolutions、urls

  • limit （可选，默认值：10）：要检索的最大相关对象数（1-40）

  • cursor （可选）：用于分页的连续光标

• 例子：

4. 域名关系工具

• 名称： get_domain_relationship

• 描述：查询域的特定关系类型，并支持分页

• 参数：

  • domain （必需）：要分析的域名

  • relationship （必需）：要查询的关系类型

    • 可用关系：caa_records、cname_records、comments、communicating_files、downloaded_files、historical_ssl_certificates、historical_whois、immediate_parent、mx_records、ns_records、parent、referrer_files、related_comments、related_references、related_threat_actors、resolutions、soa_records、siblings、subdomains、urls、user_votes

  • limit （可选，默认值：10）：要检索的最大相关对象数（1-40）

  • cursor （可选）：用于分页的连续光标

• 例子：

5.高级搜索工具

• 名称： advanced_corpus_search

• 描述：使用 VT Intelligence 查询语法在 VirusTotal 数据集中执行高级搜索

• 参数：

  • query （必需）：VT Intelligence 搜索查询字符串

  • limit （可选，默认值：20）：每页返回的最大结果数

  • cursor （可选）：用于分页的连续光标

  • descriptors_only （可选）：如果为 true，则仅检索对象描述符而不是完整对象

• 例子：

要求

• Python >= 3.11

• 有效的VirusTotal API 密钥

• 所需的 Python 包：

  • aiohttp >= 3.9.0

  • mcp[cli] >= 1.4.1

  • python-dotenv >= 1.0.0

  • 打字扩展> = 4.8.0

错误处理

该服务器包括针对以下方面的全面错误处理：

• 无效的 API 密钥

• 速率限制

• 网络错误

• 输入参数无效

• 无效的哈希格式

• 无效的 IP 格式

• 无效的 URL 格式

• 无效的关系类型

• 分页错误

发展

要在开发模式下运行：

贡献

1. 分叉存储库

2. 创建功能分支（ git checkout -b feature/amazing-feature ）

3. 提交您的更改（ git commit -m 'Add amazing feature' ）

4. 推送到分支（ git push origin feature/amazing-feature ）

5. 打开拉取请求

执照

该项目根据 Apache License 2.0 获得许可 - 有关详细信息，请参阅LICENSE文件。

致谢

• VirusTotal 提供 API 和威胁情报平台

• 服务器框架的 MCP 项目

• 贡献者和维护者

支持

如需支持，请：

1. 检查文档

2. 搜索现有问题

3. 如果需要，创建新问题

安全

• 切勿提交 API 密钥或敏感凭证

• 使用环境变量进行配置

• 处理威胁情报数据时遵循安全最佳实践