VirusTotal

VirusTotal MCP 服务

一个基于 VirusTotal API 的模型上下文协议（MCP）服务，用于全面的安全分析。该服务使用 FastMCP 和 Python 构建，为 Claude 等 AI 助手提供强大的恶意软件检测和威胁情报能力。

概述

此 MCP 服务集成了 VirusTotal 庞大的安全数据库，让 AI 助手能够对 URL、文件、IP 地址和域名执行全面的安全分析。服务会自动获取关联数据，通过单次请求提供完整的安全上下文。

功能

• 全面的安全分析：自动获取关联数据，完成全面的威胁分析
• URL 分析：提供安全报告，包含已联系的域名、已下载的文件和威胁行为者
• 文件分析：详细分析文件哈希，包括行为、释放的文件和网络连接
• IP 分析：提供地理位置、信誉数据和历史信息
• 域名分析：提供 DNS 记录、WHOIS 数据、SSL 证书和子域名
• 详细的关联查询：分页访问特定关联类型，以进行深入调查
• 遵循速率限制：遵守 VirusTotal API 的限制
• 支持多种传输方式：支持 SSE 和 STDIO 传输，满足不同的集成需求

快速开始

前提条件

• Python 3.8+ 或 Docker
• uv 包管理器（用于本地开发）
• VirusTotal API 密钥（在此获取）

安装

选项 1：Docker（推荐）

1. 克隆并设置：

   git clone https://github.com/barvhaim/virustotal-mcp-server.git
   cd virustotal-mcp-server
   

2. 配置 API 密钥：

   echo "VIRUSTOTAL_API_KEY=your_api_key_here" > .env
   

3. 使用 Docker Compose 运行：

   docker-compose up -d
   

4. 或者直接使用 Docker 运行：

   docker build -t virustotal-mcp .
   docker run -d --name virustotal-mcp -p 8000:8000 --env-file .env virustotal-mcp
   

选项 2：本地开发

1. 克隆并设置：

   git clone https://github.com/barvhaim/virustotal-mcp-server.git
   cd virustotal-mcp-server
   uv sync
   

2. 配置 API 密钥：

   echo "VIRUSTOTAL_API_KEY=your_api_key_here" > .env
   

3. 运行服务：

   # SSE transport (web-friendly)
   uv run main.py
   
   # STDIO transport (for Claude Desktop)
   MCP_TRANSPORT=stdio uv run main.py
   

可用工具

报告工具（自动获取关联数据）

1. URL 报告工具

• 名称：get_url_report
• 描述：获取全面的 URL 分析，包括安全扫描结果和关键关联数据
• 参数：
  • url（必填）：要分析的 URL
• 自动获取的关联数据：通信文件、已联系的域名/IP、已下载的文件、重定向、威胁行为者

2. 文件报告工具

• 名称：get_file_report
• 描述：使用哈希（MD5/SHA-1/SHA-256）获取全面的文件分析
• 参数：
  • hash（必填）：要分析的文件哈希
• 自动获取的关联数据：行为、释放的文件、已联系的域名/IP、嵌入的 URL、威胁行为者

3. IP 报告工具

• 名称：get_ip_report
• 描述：获取全面的 IP 地址分析，包括地理位置和信誉
• 参数：
  • ip（必填）：要分析的 IP 地址
• 自动获取的关联数据：通信文件、历史 SSL 证书、解析记录、威胁行为者

4. 域名报告工具

• 名称：get_domain_report
• 描述：获取全面的域名分析，包括 DNS 和 WHOIS 数据
• 参数：
  • domain（必填）：要分析的域名
  • relationships（可选）：要包含的特定关联数据
• 自动获取的关联数据：子域名、历史 SSL 证书、解析记录、威胁行为者

关联查询工具（用于详细分析）

1. URL 关联查询工具

• 名称：get_url_relationship
• 描述：分页查询 URL 的特定关联类型
• 参数：
  • url（必填）：要分析的 URL
  • relationship（必填）：关联类型（analyses、communicating_files、contacted_domains 等）
  • limit（可选，1-40，默认值：10）：结果数量
  • cursor（可选）：分页游标

2. 文件关系工具

• 名称：get_file_relationship
• 描述：分页查询文件的特定关系类型
• 参数：
  • hash（必填）：文件哈希
  • relationship（必填）：关系类型（behaviours、dropped_files、contacted_domains 等）
  • limit（可选，1-40，默认值：10）：结果数量
  • cursor（可选）：分页游标

3. IP 关系工具

• 名称：get_ip_relationship
• 描述：分页查询 IP 的特定关系类型
• 参数：
  • ip（必填）：IP 地址
  • relationship（必填）：关系类型（communicating_files、resolutions 等）
  • limit（可选，1-40，默认值：10）：结果数量
  • cursor（可选）：分页游标

4. 域名关系工具

• 名称：get_domain_relationship
• 描述：分页查询域名的特定关系类型
• 参数：
  • domain（必填）：域名
  • relationship（必填）：关系类型（subdomains、historical_ssl_certificates 等）
  • limit（可选，1-40，默认值：10）：结果数量
  • cursor（可选）：分页游标

Claude Desktop 集成

要将此服务连接到 Claude Desktop，请将以下内容添加到 claude_desktop_config.json：

配置文件位置：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Linux：~/.config/claude/claude_desktop_config.json
• Windows：%APPDATA%\\Claude\\claude_desktop_config.json

{
  "mcpServers": {
    "virustotal": {
      "command": "uv",
      "args": [
        "--directory",
        "/absolute/path/to/virustotal-mcp-server",
        "run",
        "main.py"
      ],
      "env": {
        "VIRUSTOTAL_API_KEY": "your_api_key_here",
        "MCP_TRANSPORT": "stdio"
      }
    }
  }
}

资源

• FastMCP 文档：github.com/jlowin/fastmcp
• MCP 规范：modelcontextprotocol.io
• VirusTotal API：developers.virustotal.com
• uv 包管理器：astral.sh/uv
• Claude Desktop：claude.ai

版本历史

• v1.0.0：首次发布，包含全面的 VirusTotal 集成
  • 8 个安全分析工具
  • 自动获取关系
  • 支持 SSE 和 STDIO 传输
  • 支持速率限制
  • 完整的错误处理