Information
VirusTotal MCP 服务器
一个用于查询 VirusTotal API 的 Model Context Protocol (MCP) 服务器。该服务器提供全面的安全分析工具，并自动获取关系数据。它无缝集成到如 Claude Desktop 这样的 MCP 兼容应用程序中。
快速开始（推荐）
通过 Smithery 安装
要通过 Smithery 自动为 Claude Desktop 安装 VirusTotal 服务器：
npx -y @smithery/cli install @burtthecoder/mcp-virustotal --client claude
手动安装
通过 npm 全局安装服务器：
npm install -g @burtthecoder/mcp-virustotal
添加到你的 Claude Desktop 配置文件中：
\{
"mcpServers": \{
"virustotal": \{
"command": "mcp-virustotal",
"env": \{
"VIRUSTOTAL_API_KEY": "your-virustotal-api-key"
\}
\}
\}
\}
配置文件位置：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
重启 Claude Desktop
替代设置（从源代码）
如果你更喜欢从源代码运行或需要修改代码：
克隆并构建：
git clone
cd mcp-virustotal
npm install
npm run build
添加到你的 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"
\}
\}
\}
\}
功能
全面的分析报告：每个分析工具都会自动获取相关的关系数据以及基本报告，从而在一个请求中提供完整的安全概览
URL 分析：带有自动获取联系域名、下载文件和威胁行为者的安全报告
文件分析：详细分析文件哈希，包括行为、丢弃的文件和网络连接
IP 分析：包含历史数据、解析记录和相关威胁的安全报告
域名分析：DNS 信息、WHOIS 数据、SSL 证书和子域
详细的关系分析：支持分页查询特定类型关系的专用工具
丰富的格式：清晰分类和呈现分析结果及关系数据
工具
报告工具（带自动关系获取）
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 (必需): 要分析的域名
relationships (可选): 要包含在报告中的特定关系数组
关系工具（用于详细分析）
1. URL 关系工具
名称: get_url_relationship
描述: 查询特定类型的 URL 关系，并支持分页。从 17 种关系类型中选择，包括分析、通信文件、联系的域名/IP、下载的文件、图表、引用者、重定向以及威胁行为者
参数:
url (必需): 要获取关系的 URL
relationship (必需): 要查询的关系类型
可用关系: analyses, comments, communicating_files, contacted_domains, contacted_ips, downloaded_files, graphs, last_serving_ip_address, network_location, referrer_files, referrer_urls, redirecting_urls, redirects_to, related_comments, related_references, related_threat_actors, submissions
limit (可选，默认值: 10): 要检索的相关对象的最大数量 (1-40)
cursor (可选): 用于分页的延续游标
2. 文件关系工具
名称: get_file_relationship
描述: 查询特定类型的文件关系，并支持分页。从 41 种关系类型中选择，包括行为、网络连接、丢弃的文件、嵌入的内容、执行链以及威胁行为者
参数:
hash (必需): 文件的 MD5、SHA-1 或 SHA-256 哈希值
relationship (必需): 要查询的关系类型
可用关系: analyses, behaviours, bundled_files, carbonblack_children, carbonblack_parents, ciphered_bundled_files, ciphered_parents, clues, collections, comments, compressed_parents, contacted_domains, contacted_ips, contacted_urls, dropped_files, email_attachments, email_parents, embedded_domains, embedded_ips, embedded_urls, execution_parents, graphs, 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, submissions, screenshots, urls_for_embedded_js, votes
limit (可选，默认值: 10): 要检索的相关对象的最大数量 (1-40)
cursor (可选): 用于分页的延续游标
3. IP 关系工具
名称: get_ip_relationship
描述: 查询特定 IP 地址的某种关系类型，并支持分页。从 12 种关系类型中选择，包括通信文件、历史 SSL 证书、WHOIS 记录、解析记录和威胁参与者等
参数:
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
描述: 查询特定域名的某种关系类型，并支持分页。从 21 种关系类型中选择，包括 SSL 证书、子域名、历史数据和 DNS 记录等
参数:
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 (可选): 分页时使用的连续游标
要求
Node.js (版本 18 或更高)
有效的 VirusTotal API 密钥
故障排除
API 密钥问题
如果您看到“错误的 API 密钥”错误：
检查位于 /tmp/mcp-virustotal-server.log（在 macOS 上）的日志文件以查看 API 密钥状态
验证您的 API 密钥：
应为有效的 VirusTotal API 密钥（通常是 64 个字符）
密钥周围没有额外的空格或引号
必须来自您的 VirusTotal 账户中的 API 密钥部分
在进行任何配置更改后：
保存配置文件
重启 Claude Desktop
检查日志以获取新的 API 密钥状态
模块加载问题
如果您看到 ES 模块加载警告：
对于全局安装：使用快速入门中显示的简单配置
对于源码安装：确保在参数中包含 --experimental-modules
开发
要以开发模式运行并启用热重载：
npm run dev
错误处理
服务器包括全面的错误处理机制，涵盖以下情况：
无效的 API 密钥
速率限制
网络错误
无效的输入参数
无效的哈希格式
无效的 IP 格式
无效的 URL 格式
无效的关系类型
分页错误
版本历史
请注意，原文档中关于开发环境下的具体命令行示例被截断了，标记为 #5 的部分可能需要根据实际开发指南补充完整信息。如果还有更多细节或有其他章节需要翻译，请告知！
v1.0.0: 初始版本，包含核心功能
v1.1.0: 添加了针对 URL、文件和 IP 地址的关系分析工具
v1.2.0: 增强了错误处理和日志记录
v1.3.0: 为关系查询添加了分页支持
v1.4.0: 在报告工具中添加了自动关系获取，并支持域名分析
贡献
叉取仓库
创建一个特性分支 (git checkout -b feature/amazing-feature)
提交你的更改 (git commit -m 'Add amazing feature')
推送到该分支 (git push origin feature/amazing-feature)
打开一个 Pull Request
许可证
本项目采用 MIT 许可证 - 详情请参阅 LICENSE 文件。