shield_lock
JinDaGe
← Back to MCP directory
publicPublicdnsLocal runtime

mcp-clamav

基于ClamAV引擎的简单病毒扫描MCP服务，支持通过SSE连接进行文件扫描。

article

README

🚀 ClamAV MCP

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

Cursor ClamAV Integration

🚀 快速开始

✨ 主要特性

  • 借助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：如果扫描失败，则返回错误消息
help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client