ClamAV MCP

基本能力

产品定位

ClamAV MCP 是一个用于文件病毒扫描的服务，基于 ClamAV 引擎，提供简单的 API 接口。

核心功能

1. 文件病毒扫描：支持通过 API 扫描文件，检测病毒。
2. 集成 ClamAV 引擎：利用 ClamAV 的强大病毒检测能力。
3. 简单易用：提供简单的 API 接口，方便集成到其他应用中。

适用场景

1. 文件上传前的病毒扫描。
2. 集成到开发工具（如 Cursor）中进行文件安全检查。
3. 自动化病毒扫描流程。

工具列表

1. clamscan：ClamAV 的核心扫描工具，用于检测文件中的病毒。
2. clamav-daemon：ClamAV 的守护进程，支持后台扫描服务。

常见问题解答

1. 如何安装 ClamAV？
2. Ubuntu/Debian: sudo apt-get install clamav clamav-daemon
3. Windows: 从 ClamAV 官网下载安装包并安装。
4. macOS: brew install clamav
5. 如何启动 MCP 服务器？
6. 使用命令 uv run mcp run main.py -t sse。
7. 如何配置 Cursor 使用该服务？
8. 在 Cursor 配置中添加 "url": "http://[SERVER_IP]:8000/sse"。

使用教程

使用依赖

安装 ClamAV：

• Ubuntu/Debian bash sudo apt-get update sudo apt-get install clamav clamav-daemon

• Windows

• 从 ClamAV 官网 下载安装包。
• 运行安装程序并按照向导完成安装。

• 确保将 ClamAV 添加到系统 PATH 中。

• macOS bash brew install clamav

安装教程

启动 MCP 服务器：

uv run mcp run main.py -t sse

调试方式

1. 确保 ClamAV 已正确安装并运行。
2. 检查 MCP 服务器是否监听在默认端口 8000。
3. 使用 API 端点 scan_file 测试文件扫描功能。

API

scan_file

• 参数：
• base64_data: 文件的 Base64 编码字符串。
• filename: 用于扫描的文件名。
• 返回：
• success: 布尔值，表示扫描是否成功。
• result: clamscan 命令的原始输出。
• error: 如果扫描失败，返回错误信息。

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。