oVirt MCP Server

An MCP (Model Context Protocol) server for managing oVirt / Red Hat Virtualization (RHV) environments via AI assistants such as Claude.

Requirements

• Python 3.10+
• Access to an oVirt Engine or RHV Manager instance
• An account with sufficient permissions (read-only for queries; admin for power operations)

Installation

git clone https://github.com/your-org/ovirt-mcp-server.git
cd ovirt-mcp-server

python -m venv .venv
source .venv/bin/activate

pip install -r requirements.txt

Configuration

Copy the example environment file and fill in your values:

cp env.example .env

Variable	Description	Example
OVIRT_HOST	oVirt Engine hostname or IP	ovirt.domain.local
OVIRT_USER	Username (include domain)	admin@internal
OVIRT_PASSWORD	Password
OVIRT_INSECURE	Skip SSL verification (True/False)	True

Set OVIRT_INSECURE=False in production environments with a valid certificate.

Running the server

python ovirt_mcp_server.py

The server communicates over stdio (standard MCP transport).

Claude Code integration

Add the server to your Claude Code MCP configuration (~/.claude/settings.json):

{
  "mcpServers": {
    "ovirt": {
      "command": "/path/to/ovirt-mcp-server/.venv/bin/python",
      "args": ["/path/to/ovirt-mcp-server/ovirt_mcp_server.py"],
      "env": {
        "OVIRT_HOST": "ovirt.domain.local",
        "OVIRT_USER": "admin@internal",
        "OVIRT_PASSWORD": "your_password",
        "OVIRT_INSECURE": "True"
      }
    }
  }
}

Alternatively, use a .env file in the project directory instead of inlining credentials in the config.

Available tools

VM Management

Tool	Description
list_vms	List VMs with optional oVirt search query
get_vm_details	Full details for a specific VM
get_vm_nics	Network interfaces for a VM
get_vm_disks	Disk information for a VM
get_vm_statistics	CPU, memory, and network stats
get_vm_events	Recent events for a VM
get_vm_by_ip	Find a VM by IP address
search_vms	Search VMs by query string
generate_vm_report	Summary report of all VMs
get_vms_with_high_resource_usage	VMs exceeding CPU/memory thresholds

Power Operations

Tool	Description
power_on_vm	Start a VM
shutdown_vm	Graceful shutdown
power_off_vm	Force power off (requires confirm=true)
reboot_vm	Reboot a VM
suspend_vm	Suspend a VM
bulk_power_operations	Power on/off/reboot multiple VMs

VM Lifecycle

Tool	Description
migrate_vm	Migrate VM to a different host
delete_vm	Delete a VM (requires confirm=true)
modify_vm_resources	Change CPU/memory allocation

Snapshots

Tool	Description
list_vm_snapshots	List snapshots for a VM
create_vm_snapshot	Create a snapshot
delete_vm_snapshot	Delete a snapshot (requires confirm=true)

Infrastructure

Tool	Description
list_hosts	List hypervisor hosts
get_host_details	Details for a specific host
get_host_statistics	CPU, memory, and network stats for a host
list_clusters	List clusters
get_cluster_details	Details for a specific cluster
list_datacenters	List datacenters
list_storage_domains	List storage domains
get_storage_domain_details	Details for a storage domain
list_networks	List networks
list_templates	List VM templates
get_events	Retrieve global oVirt events

Notes

• Destructive operations (delete_vm, power_off_vm, delete_vm_snapshot, bulk_power_operations) require an explicit confirm=true parameter.
• All VM and host lookups accept oVirt UUIDs. Use list_vms or search_vms to find IDs.
• The oVirt REST API must be reachable from the machine running this server.