mcpField
C
ClamAV MCP

ClamAV MCP

Remote
github.com/a2amarketSecurity3Updated 79w ago
Repository

About ClamAV MCP

ClamAV MCP is an MCP server that uses the ClamAV engine to scan files for viruses. It accepts SSE connections and returns scan output or error information to clients.

Key features

  1. 01Scan files with ClamAV
  2. 02Accept Base64-encoded files
  3. 03Return raw scan command output
  4. 04Report scan errors
  5. 05Accept connections over SSE

Use cases

  1. 01Check uploaded files for viruses
  2. 02Scan files passed as encoded data
  3. 03Call file scans from Cursor

MCP support

The server exposes a scan_file tool to MCP clients, taking Base64 file data and a filename and returning scan status, output, or an error.

#clamav#virus-scanner#security

Configuration

Remote servers need no local install. Pick your client, then copy the config or install in one click.

Endpointhttp://127.0.0.1:8000/sse
Copy install command
Claude CodeTerminal
Cursor.cursor/mcp.json
VS Code.vscode/mcp.json
Claude Desktopclaude_desktop_config.json
Windsurf~/.codeium/windsurf/mcp_config.json

Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.

Tools

Details

From the project README

ClamAV MCP

Simple ClamAV MCP that allows scanning files for viruses using the ClamAV engine.

Cursor ClamAV Integration

Requirements

This project requires ClamAV to be installed on your system. Here's how to install it:

Ubuntu/Debian
sudo apt-get update
sudo apt-get install clamav clamav-daemon
Windows
  1. Download the ClamAV installer from ClamAV's official website
  2. Run the installer and follow the setup wizard
  3. Make sure to add ClamAV to your system PATH
macOS
brew install clamav

Usage

To run the MCP server:

uv run mcp run main.py -t sse

The server will start and listen for SSE connections on port 8000 by default.

Cursor Configuration

To use this MCP with Cursor, add the following configuration to your Cursor settings:

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

This configuration tells Cursor to connect to the ClamAV MCP server.

API

The MCP provides a single endpoint:

scan_file
  • Parameters:
    • base64_data: Base64 encoded string of the file to scan
    • filename: Name of the file to use in the scan
  • Returns:
    • success: Boolean indicating if the scan was successful
    • result: Raw output from clamscan command
    • error: Error message if the scan failed

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.