# @burtthecoder/mcp-virustotal 中文文档
规范地址：https://npmcn.com/package/%40burtthecoder/mcp-virustotal/
版本：1\.0\.38
npm 元数据更新时间：2026-11-04T21:16:48.464Z
中文译文更新时间：2026-11-08T20:23:01.684Z
软件包许可：MIT
本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。
原始 npm 页面：https://www.npmjs.com/package/%40burtthecoder/mcp-virustotal
原文对照：https://npmcn.com/package/%40burtthecoder/mcp-virustotal/?lang=original
项目主页：https://w0h1v.github.io/mcp-virustotal/
源码仓库：https://github.com/w0h1v/mcp-virustotal
## 关键信息（来自 npm 元数据）
- 包体积（解压后）：95.3 kB，26 个文件
- 模块格式：ES Module
- TypeScript 类型：未声明
- Node.js 要求：\>=20
- 运行依赖：4 个
- 首次发布：2024-12-13T00:35:13.056Z
- 最新版本发布：2026-11-04T21:16:48.099Z
- 近 30 天下载量：4694（2026-10-09 至 2026-11-07，npm 官方下载统计）
- 已发布版本数：32（近 12 个月 21 个）
## 中文简介
VirusTotal API 整合的 MCP 服务器
## 安装
```sh
npm install @burtthecoder/mcp-virustotal
```
也可以使用：`pnpm add @burtthecoder/mcp-virustotal`、`yarn add @burtthecoder/mcp-virustotal`、`bun add @burtthecoder/mcp-virustotal`
## README
[](https://www.npmjs.com/package/@burtthecoder/mcp-virustotal) [](https://github.com/w0h1v/mcp-virustotal/actions/workflows/ci.yml) [](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/LICENSE)  [](https://registry.modelcontextprotocol.io/)
[快速启动](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/#readme-quickstart) • 妇女 [工具](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/#readme-tools) • 妇女 [HTTP 密码](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/#readme-http-streaming-transport) • 妇女 [警卫](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/#readme-security) • 妇女 [解决问题](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/#readme-troubleshooting) • 妇女 [文档](https://w0h1v.github.io/mcp-virustotal/)
**mcp-病毒总计** 是一个 [MCP 磁共振](https://modelcontextprotocol.io/) 允许 AI 代理机访问 [病毒总数 v3 API](https://docs.virustotal.com/reference/overview)。将您的代理人递回散列、 URL、 IP 或域名, 并获取检测报告, 以及分析师将选择的关系: 联系上的主机、 丢弃文件、 解析度、 威胁行为者 .
> \[注\] 独立项目,不隶属于VirusTotal或Google. 你需要你自己来 [病毒总计 API 密钥](https://www.virustotal.com/gui/my-apikey)。 。 。 .
## 要点
- **有关系的报告.** 文件、 URL、 IP 和域名报告按批次获取密钥关系 `?relationships=` 要求节省配额.
- **缓存先取.** `get_url_report` 返回缓存的 VirusTotal 报告,只提交缓存错失的扫描.
- **关键工具.** 使用 VTI 风格的修饰器进行 Corpus 搜索(`type:peexe positives:5+`),并合并了沙盒行为总结,以及威胁行为人和恶意软件家庭收藏.
- **完全的关系呼唤.** 100+ 跨文件, URL, IP和域的关系类型, 有光标 pagination.
- **二通运.** 用于桌面客户端的stdio,用于共享服务的HTTP流.
- **经验.** 在节点20、22和24上对CI中的格式器和API层进行单元测试.
## 如何运作
```mermaid
flowchart LR
A["AI agent
(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-virustotal"]
S -->|"validate input,
HTTPS + API key"| V["VirusTotal v3 API"]
V -->|"JSON"| S
S -->|"formatted report text"| A
```
## 快速启动
**所需经费:** 节点.js 20或更新 和病毒Total API 键.
```sh
# Claude Code
claude mcp add --transport stdio --env VIRUSTOTAL_API_KEY=your-key virustotal -- npx -y @burtthecoder/mcp-virustotal
# Codex CLI
codex mcp add virustotal --env VIRUSTOTAL_API_KEY=your-key -- npx -y @burtthecoder/mcp-virustotal
# Gemini CLI
gemini mcp add -e VIRUSTOTAL_API_KEY=your-key virustotal npx -y @burtthecoder/mcp-virustotal
```
关于Claude桌面, VS 代码和源代码运行,请参见 [连接客户端](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/docs/clients.md)。 。 。 .
那就问问你的经纪人: _"寻找SHA -256 `275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f` (EICAR测试文件) 并显示它所掉落的东西和联系人"_
## 工具
十一用具来. 完整的参数和关系清单载于 [工具参考](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/docs/tools.md)。 。 。 .
| 组 | 工具 |
| --- | --- |
| 报告(有关系) | `get_file_report`, (中文(简体) ), `get_url_report`, (中文(简体) ), `get_ip_report`, (中文(简体) ), `get_domain_report` |
| 关系呼唤 | `get_file_relationship`, (中文(简体) ), `get_url_relationship`, (中文(简体) ), `get_ip_relationship`, (中文(简体) ), `get_domain_relationship` |
| 搜索和中枢 | `search_vt`, (中文(简体) ), `get_file_behaviour_summary`, (中文(简体) ), `get_collection` |
## HTTP 流线运输
stdio是默认值. 设定 `MCP_TRANSPORT=httpStream` 运行独立的 HTTP 服务 :
```sh
MCP_TRANSPORT=httpStream MCP_PORT=3000 VIRUSTOTAL_API_KEY=your-key node build/index.js
```
```sh
docker build -t mcp-virustotal .
docker run -p 127.0.0.1:3000:3000 -e VIRUSTOTAL_API_KEY=your-key -e MCP_TRANSPORT=httpStream mcp-virustotal
```
健康检查服务于 `/health`。 。 。 .
### 环境变量
| 变量 | 默认 | 说明 |
| --- | --- | --- |
| `VIRUSTOTAL_API_KEY` | _(必须)_ | 您的病毒总 API 密钥 |
| `MCP_TRANSPORT` | `stdio` | `stdio` 或者说 `httpStream` |
| `MCP_HOST` | `localhost` | 绑定地址( N)`httpStream` 页:1 Docker 图像集 `0.0.0.0` |
| `MCP_PORT` | `3000` | HTTP 端口 (% 1)`httpStream` 仅限) |
| `MCP_ENDPOINT` | `/mcp` | HTTP 端点路径 (`httpStream` 仅限) |
## 警卫
> \[尖叫声\] HTTP运输系统 **无认证**。将端口保留在本地主机上,或者在认证的倒置代理后,或者任何人能够到达端口,都可以使用您的 API 配额.
- 工具参数在构建任何请求之前先由zod schemas验证.
- API密钥是从环境中读取的,只发送到VirusTotal.
- 检查会把指示器送到病毒中心 对缓存错误的 URL 扫描会提交该 URL 进行分析 .
私下报告脆弱性;见 [警卫](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/SECURITY.md)。 。 。 .
## 解决问题
- **错误的 API 密钥 :** 键通常是64个字符,没有空格或引号。 更改配置后重新启动客户端 .
- **429个错误 :** 公共级别允许每分钟4个请求.
- **日志 :** `logs/mcp-virustotal-server.log` 在软件包目录中.
再来点 [解决问题指南](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/docs/troubleshooting.md)。 。 。 .
## 发展
```sh
git clone https://github.com/w0h1v/mcp-virustotal && cd mcp-virustotal
npm ci
npm test # build + unit tests, no key or network
VIRUSTOTAL_API_KEY=your-key npm run smoke # all 11 tools against the real API
```
烟雾测试节奏要求为公测限值20s,不适合每天减为几层免费水平. 见 [捐款额](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/CONTRIBUTING.md) 编辑 [更改日志](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/CHANGELOG.md)。 。 。 .
## 许可证
麻省理工学院. 见 [自由主义](https://npmcn.com/package/%40burtthecoder/mcp-virustotal/LICENSE)。 。 。 .
## 常见问题
### @burtthecoder/mcp-virustotal 是什么？
VirusTotal API 整合的 MCP 服务器
### 如何安装 @burtthecoder/mcp-virustotal？
在项目目录运行 npm install @burtthecoder/mcp-virustotal，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 mcp-virustotal，可以用 npx mcp-virustotal 直接运行。
### @burtthecoder/mcp-virustotal 支持 TypeScript 吗？
该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/burtthecoder\_\_mcp-virustotal 是否存在。
### @burtthecoder/mcp-virustotal 支持 ESM 还是 CommonJS？
以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。
### @burtthecoder/mcp-virustotal 需要什么版本的 Node\.js？
package\.json 的 engines 字段要求 Node\.js \>=20。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。
### @burtthecoder/mcp-virustotal 可以商用吗？
@burtthecoder/mcp-virustotal 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。
### @burtthecoder/mcp-virustotal 的下载量有多少？
根据 npm 官方下载统计，@burtthecoder/mcp-virustotal 在 2026/10/09 – 2026/11/07 这 30 天内被下载 4,694 次，日均约 156 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。
### @burtthecoder/mcp-virustotal 还在维护吗？
最新版本 1\.0\.38 发布于 2026/11/05（4 天前）；至今共发布 32 个版本，其中过去 12 个月发布了 21 个；首次发布于 2024/12/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。