官方 VirusTotal MCP 服务器可在你的智能体打开链接、运行下载的文件或调查可疑基础设施之前,为其提供威胁情报。vt-mcp 将 MCP 客户端连接到 VTAI,提供文件、URL、域名和 IP 地址的报告,支持提交文件与网络分析,以及回执恢复。
使用免费的 VTAI 服务及其当前访问限制。你无需自己的 VirusTotal API 密钥。
在兼容的远程 MCP 客户端中使用 https://ai.virustotal.com/mcp。使用你的 VTAI 账户登录并批准该连接的权限;无需本地 Python 安装、静态令牌或个人 VirusTotal API 密钥。
官方插件包含 OAuth 连接、威胁情报技能,以及针对文件哈希、URL、域名和 IP 地址的现有报告。它不包含钩子或捆绑脚本;本地文件通过哈希进行检查。
claude plugin marketplace add VirusTotal/virustotal-mcp
claude plugin install virustotal@virustotal
需要 Claude Code 2.1.283 或更高版本。该插件无需单独安装 Node.js,也不会运行任何钩子或捆绑脚本。该插件包含 https://ai.virustotal.com/mcp。
如果你要用该插件替换现有的手动连接,请先阅读 迁移与恢复指南 再移除任何内容。请先通过原始连接恢复不确定的提交;如果你选择该替代方案,请保留一个可用的手动连接。
启动新会话或使用 /reload-plugins,然后在需要时使用 /mcp 完成浏览器登录。该插件已提供 MCP 连接;请勿添加重复连接。参见插件设置、文件检查与提交选项。
如需不使用插件技能建立远程连接,请使用:
claude mcp add --transport http virustotal https://ai.virustotal.com/mcp
打开 Claude Code,运行 /mcp,选择 virustotal 并完成浏览器登录。
参见 Claude Code OAuth 说明
以及 VirusTotal 连接指南。
选择此替代方案或插件。添加服务器即完成配置;请完成身份验证并执行一次工具调用,以确认
连接正常工作。
OAuth 连接共享已登录 VTAI 账户的免费配额,并使用
为每个连接批准的权限。现有 Agent Token 保留其权限
和配额。如果你的客户端需要可配置的 HTTP 头,请使用一个受保护的
Authorization: Bearer 或 x-apikey 凭据,而不是 OAuth。其他本地
客户端可以使用下方的 stdio 安装。
~/.config/vt-mcp/token。将 MCP 服务器的环境变量 VTAI_TOKEN_FILE 设置为该路径,并将其命令设置为 vt-mcp。该文件仅包含令牌;切勿将令牌本身放入聊天、命令参数或项目文件中。| 客户端 | 配置方式 |
|---|---|
Antigravity CLI (agy) | 带 MCP 和 skill 的 Marketplace 插件、本地 stdio 或 原生 OAuth 方案 |
| Claude Code | 带威胁情报 skill 的 OAuth 插件、HTTP 或 本地 stdio |
| Codex | HTTP 或 本地 stdio |
| ChatGPT | 安装已发布的 VirusTotal 插件 · 连接指南 |
| Cursor | HTTP 方案 |
| VS Code with GitHub Copilot | HTTP 方案 |
| GitHub Copilot CLI | HTTP OAuth 方案 或 本地 stdio |
| Devin CLI | HTTP OAuth 方案 或 本地 stdio |
| Windsurf / Devin Desktop | Cascade HTTP 方案 |
| Antigravity IDE | 本地 stdio 配置 或 原生 OAuth 方案 |
| Gemini CLI | 安装 OAuth 扩展 |
| Gemini Apps | 自定义 MCP 连接 以及可选的 可导入 skill,受 Google 账户和地区可用性限制;托管工作流的完整验证尚待完成 |
| Grok Build | 手动安装插件;OAuth、报告和续期已验证 |
| Kimi Code | 手动安装插件;OAuth、报告和主动续期已使用外部模型验证 |
GitHub Copilot CLI 和 Devin CLI 的远程 OAuth 配置遵循其官方文档;经 OAuth 认证的 VirusTotal 工具工作流尚未在这两个客户端中验证。
有关 Qwen Code、Mistral Vibe Work、Grok web 和 xAI Responses API 的更多远程客户端方案及其验证限制,请参阅其他远程客户端方案。 Qwen Code 0.25.1 存在已知的 OAuth 凭据存储与 VTAI 不兼容问题; 仅靠浏览器授权无法完成其连接。
客户端验证指南区分了已记录的配置、本地传输检查和已用模型实际运行的工作流。一份配方并不代表在每个客户端中都完成了完整验证。其他 agent 可以使用相同的 MCP 端点,或直接使用 VTAI API。
在 ChatGPT 中,安装已发布的 VirusTotal 插件,在提示时使用 Google 连接,然后在新对话中选择 @VirusTotal。已发布的插件不需要开发者模式;账户和工作区策略仍然适用。连接指南包含了单独的自定义应用替代方案和验证限制。初始 OAuth 授权、IP 报告和自动令牌续期已于 2026-09-24 分别验证;发布并不代表验证了每个工作流。
对于首次查询,请向你的 agent 提问:
使用 VirusTotal 获取 virustotal.com 的域名报告。显示来源、分析日期、覆盖范围和报告链接。
在 ChatGPT 中,请在提示词前加上 @VirusTotal。报告查询不会读取或上传本地文件。缺失的报告仍属未知,零检测结果并不能证明安全。
对于本地 stdio,请安装 uv 并运行:
uv tool install --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version
本地 MCP 服务器支持 Linux、macOS 和 Windows,包括两个文件提交工具。Windows 提交回执需要本地 NTFS 存储;网络共享和重解析点会被拒绝。单独的 vt-mcp guard 命令仍然仅限 Linux。
如需自动配置客户端,请在设置指南中选择 Agy、Claude Code 或 Codex,然后打开其 Agent Token 备选方案并选择你的操作系统。安装程序使用仅限所有者的 POSIX 权限或仅限 Windows 用户的 ACL 来保护令牌。
该命令会从官方 PyPI 索引在隔离的工具环境中安装该包。需要 Python 3.12 或更高版本。请将 vt-mcp 保留在 MCP 客户端的 PATH 中,或使用其绝对可执行文件路径。该包不会修改客户端配置。
在设置指南中打开客户端的 Agent Token 备选方案,以检查已配置的传输方式,并在不创建另一个令牌的情况下更新由安装程序管理的安装。访问检查使用 GET /api/v3/agents/me/access,不产生查询费用;实际报告查询会消耗配额。更新后请重启客户端。访问检查或配置检查不会实际调用工具,也不能证明模型的行为。
如果你的客户端运行的是手动安装的 vt-mcp 可执行文件,请升级该环境:
uv tool install --upgrade --python 3.12 --default-index https://pypi.org/simple 'vt-mcp==0.9.9'
vt-mcp --version
配置了 uvx ... vt-mcp==<version> 的客户端会使用该固定版本,与已安装的可执行文件无关。请更新其版本固定,或使用安装指南。托管 HTTP 连接使用已部署的服务器;它们不需要本地软件包升级。请保留现有令牌和提交回执。
缺少报告、配额和临时服务错误会包含 next_steps 和文档链接。缺少报告会使文件或指标处于未知状态;请验证其哈希或值。报告查询绝不会授权提交或重新分析。仅在用户明确请求该操作时使用提交工具,并遵循下方的共享指南。为预期的网络操作保留文件的 SHA256 或新的 UUIDv4 request_id,然后使用该标识符进行恢复。在配额或临时服务失败时,若存在 retry_after_seconds 则遵循该值,保留凭据并避免紧密重试循环。切勿自动重放不确定的提交或替换其请求 ID:请先恢复其回执。
在代理面板中,打开 MCP Servers → Manage MCP Servers → View raw config,并将此条目与现有配置合并:
{
"mcpServers": {
"virustotal": {
"command": "vt-mcp",
"args": [],
"env": {
"VTAI_TOKEN_FILE": "~/.config/vt-mcp/token"
}
}
}
}