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

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

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

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

brew install clamav

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.

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.

The MCP provides a single endpoint:

• 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