快速启动 • 妇女 工具 • 妇女 HTTP 密码 • 妇女 警卫 • 妇女 解决问题 • 妇女 文档
mcp-病毒总计 是一个 MCP 磁共振 允许 AI 代理机访问 病毒总数 v3 API。将您的代理人递回散列、 URL、 IP 或域名, 并获取检测报告, 以及分析师将选择的关系: 联系上的主机、 丢弃文件、 解析度、 威胁行为者 .
[注] 独立项目,不隶属于VirusTotal或Google. 你需要你自己来 病毒总计 API 密钥。 。 。 .
要点
- 有关系的报告. 文件、 URL、 IP 和域名报告按批次获取密钥关系
?relationships=要求节省配额. - 缓存先取.
get_url_report返回缓存的 VirusTotal 报告,只提交缓存错失的扫描. - 关键工具. 使用 VTI 风格的修饰器进行 Corpus 搜索(
type:peexe positives:5+),并合并了沙盒行为总结,以及威胁行为人和恶意软件家庭收藏. - 完全的关系呼唤. 100+ 跨文件, URL, IP和域的关系类型, 有光标 pagination.
- 二通运. 用于桌面客户端的stdio,用于共享服务的HTTP流.
- 经验. 在节点20、22和24上对CI中的格式器和API层进行单元测试.
如何运作
flowchart LR
A["AI agent<br/>(Claude, Codex, Gemini, VS Code)"] -->|"MCP over stdio or HTTP"| S["mcp-virustotal"]
S -->|"validate input,<br/>HTTPS + API key"| V["VirusTotal v3 API"]
V -->|"JSON"| S
S -->|"formatted report text"| A
快速启动
所需经费: 节点.js 20或更新 和病毒Total API 键.
# 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 代码和源代码运行,请参见 连接客户端。 。 。 .
那就问问你的经纪人: "寻找SHA -256 275a021bbfb6489e54d471899f7db9d1663fc695ec2fe2a2c4538aabf651fd0f (EICAR测试文件) 并显示它所掉落的东西和联系人"
工具
十一用具来. 完整的参数和关系清单载于 工具参考。 。 。 .
| 组 | 工具 |
|---|---|
| 报告(有关系) | 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 服务 :
MCP_TRANSPORT=httpStream MCP_PORT=3000 VIRUSTOTAL_API_KEY=your-key node build/index.js
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 进行分析 .
私下报告脆弱性;见 警卫。 。 。 .
解决问题
- 错误的 API 密钥 : 键通常是64个字符,没有空格或引号。 更改配置后重新启动客户端 .
- 429个错误 : 公共级别允许每分钟4个请求.
- 日志 :
logs/mcp-virustotal-server.log在软件包目录中.
再来点 解决问题指南。 。 。 .
发展
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,不适合每天减为几层免费水平. 见 捐款额 编辑 更改日志。 。 。 .
许可证
麻省理工学院. 见 自由主义。 。 。 .