mcp-clamav

🚀 ClamAV MCP

ClamAV MCP是一个简单的工具，它借助ClamAV引擎对文件进行病毒扫描，为你的文件安全保驾护航。

🚀 快速开始

✨ 主要特性

• 借助ClamAV引擎实现文件病毒扫描功能。
• 可与Cursor工具集成，方便使用。

📦 安装指南

该项目需要在你的系统上安装ClamAV，以下是不同系统的安装方法：

Ubuntu/Debian

sudo apt-get update
sudo apt-get install clamav clamav-daemon

Windows

1. 从ClamAV的官方网站下载ClamAV安装程序。
2. 运行安装程序并按照设置向导进行操作。
3. 确保将ClamAV添加到系统PATH中。

macOS

brew install clamav

💻 使用示例

基础用法

要运行MCP服务器：

uv run mcp run main.py -t sse

服务器启动后，默认将在8000端口监听SSE连接。

📚 详细文档

Cursor配置

要将此MCP与Cursor一起使用，请在你的Cursor设置中添加以下配置：

{
  "mcpServers": {
    "ClamAV Server": {
      "url": "http://[SERVER_IP]:8000/sse"
    }
  }
}

此配置告诉Cursor连接到ClamAV MCP服务器。

🔧 技术细节

API

MCP提供一个端点：

scan_file

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