🚀 VirusTotal 服务端配置与使用指南

本指南将帮助您轻松配置和使用 VirusTotal 服务端工具，实现高效的安全分析和威胁检测。

🚀 快速开始

📦 安装

通过 npm 进行全局安装：

npm install mcp-virustotal-server -g

⚙️ 配置步骤

1. 创建配置文件目录并编辑配置文件：

   mkdir ~/.config/mcp-virustotal-server
   nano ~/.config/mcp-virustotal-server/config.json
   

2. 在 config.json 文件中添加以下内容：

   {
     "port": 8090,
     "vtApiKey": "your_virus_total_api_key_here"
   }
   

3. 启动服务：

   mcp-virustotal-server
   

💻 使用示例

基础用法

查询文件哈希：

curl -X POST http://localhost:8090/file \
     --form file=@/path/to/file

✨ 主要特性

🌟 核心功能

• 文件分析：支持通过上传文件或提供哈希值进行恶意软件检测。
• URL 扫描：检查指定 URL 的安全性，包括网络和声誉分析。
• IP 分析：评估特定 IP 地址的信誉状况。

⭐ 高级特性

• 自定义阈值：根据需求调整威胁检测的敏感度。
• 日志记录：详细记录所有操作和结果，便于审计和回溯。
• 多线程处理：提升大规模数据处理效率。

📚 详细文档

📝 深入配置

🌐 日志管理

默认情况下，日志文件位于 /tmp/mcp-virustotal-server.log。可以通过修改配置文件中的 logFile 参数来指定其他存储路径：

{
  "port": 8090,
  "vtApiKey": "your_api_key",
  "logFile": "/var/log/virus_total.log"
}

🔒 安全强化

• SSL 加密：启用 HTTPS 来保障通信安全。
• 访问控制：通过配置 IP 白名单或黑名单限制服务访问。

❓ 故障排除

🛠️ 常见问题

1. API 错误
   • 检查日志文件 /tmp/mcp-virustotal-server.log 中的 API 错误信息。
   • 确认 VirusTotal API 密钥的有效性和正确性。
2. 模块加载问题
   • 使用全局安装方式避免模块加载警告。
   • 在开发环境中，确保运行命令包含 --experimental-modules 参数。

🚑 详细错误处理

服务内置了全面的错误捕捉机制，涵盖：

• 不合法的 API 密钥
• 请求速率限制
• 网络连接中断
• 无效输入参数

💻 开发指南

▶️ 运行与调试

npm run dev

🤝 贡献代码

1. Fork 项目仓库。
2. 创建功能分支：

   git checkout -b feature/新增特性名称
   

3. 提交修改并推送至分支。
4. 提出 Pull Request。

📜 版本更新记录

• v1.0.0：首次发布，包含基本功能。
• v1.1.0：增加关系分析工具。
• v1.2.0：优化错误处理和日志系统。
• v1.3.0：引入分页支持，提升数据处理效率。

📄 许可证

本项目遵循 MIT 许可证，具体内容请参考 LICENSE 文件。