GreenboneMCP

Overview

GreenboneMCP is an MCP server that bridges AI assistants with Greenbone/OpenVAS vulnerability management systems through GMP (Greenbone Management Protocol). It exposes MCP tools for comprehensive scan workflows, including scan creation, monitoring, report fetching, and comparison. This Python-based server operates on stdio transport and communicates with gvmd through Unix socket, making it suitable for Dockerized environments with Greenbone Community Edition installations.

Try asking AI

After installing, here are 3 things you can ask your AI assistant:

• start_scan

  Start a new scan in Greenbone/OpenVAS

  Try:Start a vulnerability scan on the network range 192.168.1.0/24Try:Initiate a new scan using the Quick default scan config
• scan_status

  Check the current status of a running scan

  Try:What's the status of scan with ID 123?Try:Check if the scan on target 'web-servers' is complete
• fetch_latest_report

  Retrieve the most recent scan report

  Try:Get me the latest vulnerability scan reportTry:Fetch the report from the scan that just completed
• restart_scan

  Restart a scan that has been stopped or failed

  Try:Restart the scan with ID 456Try:Launch the web-app scan again
• delta_report

  Compare two reports to see differences in vulnerabilities

  Try:Compare the last two scan reports to see what new vulnerabilities appearedTry:Show me the difference between the scan from last week and this week
• get_targets

  List all configured scan targets

  Try:Show me all configured targetsTry:List the available scan targets in the system
• get_target

  Retrieve details of a specific target

  Try:Get details for target ID 789Try:Show me the configuration for 'internal-network' target
• get_tasks

  List all scan tasks

  Try:Show me all scheduled scan tasksTry:List the current tasks in the system
• get_port_lists

  Retrieve available port lists for scanning

  Try:Show me the port lists available for scanningTry:List all configured port lists
• start_task

  Start a specific scan task

  Try:Start task ID 101Try:Launch the quarterly compliance scan now
• stop_task

  Stop a running scan task

  Try:Stop the scan task that's currently runningTry:Abort the scan with ID 202

Comparable tools

Installation

git clone https://github.com/matteocolazilli/GreenboneMCP.git
cd GreenboneMCP

docker build -t greenbonemcp:latest .

cp .env.example .env

docker run --rm -i --env-file <path-to-your-env-file> --name greenbonemcp --volume greenbone-community-edition_gvmd_socket_vol:/run/gvmd greenbonemcp:latest

{
  "mcpServers": {
    "greenbone": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "--env-file", "/path/to/.env", "--volume", "greenbone-community-edition_gvmd_socket_vol:/run/gvmd", "greenbonemcp:latest"]
    }
  }
}

Compare GreenboneMCP with