Ovirt Engine MCP Server

oVirt MCP服务器

A. 模型上下文协议 （MCP）服务器 oVirt /RHV虚拟化管理。提供150多种工具，用于管理VM、主机、集群、网络、存储、模板、快照、磁盘、事件、关联组、RBAC、配额、检查点、迁移、VM池等，使Claude等AI助手能够与您的虚拟化基础设施进行交互。

特性

• 150+MCP工具 --VM、主机、集群、网络、存储、模板、快照、磁盘、事件、关联组、RBAC、配额、检查点、迁移、VM池等的完整生命周期管理
• 真正的SDK集成 --基于 ovirtsdk4，官方oVirt Python SDK
• 标准运输 --适用于Claude Desktop、OpenClaw和任何兼容MCP的客户端
• 结构化错误 --清除错误代码并重试指导
• 输入验证 --所有工具的类型安全参数验证

快速开始

1.安装

pip install ovirt-engine-mcp-server

或来源：

git clone https://github.com/imjoey/ovirt-engine-mcp-server.git
cd ovirt-engine-mcp-server
pip install -e .

2.配置

设置环境变量（推荐）：

export OVIRT_ENGINE_URL="https://ovirt-engine.example.com"
export OVIRT_ENGINE_USER="admin@internal"
export OVIRT_ENGINE_PASSWORD="your-password"

或者创建一个 config.yaml:

OVIRT_ENGINE_URL: https://ovirt-engine.example.com
OVIRT_ENGINE_USER: admin@internal
# OVIRT_ENGINE_PASSWORD should be set via environment variable

3.跑步

ovirt-engine-mcp

Claude桌面集成

添加到您的Claude Desktop配置文件(claude_desktop_config.json):

{
  "mcpServers": {
    "ovirt": {
      "command": "ovirt-engine-mcp",
      "env": {
        "OVIRT_ENGINE_URL": "https://ovirt-engine.example.com",
        "OVIRT_ENGINE_USER": "admin@internal",
        "OVIRT_ENGINE_PASSWORD": "your-password"
      }
    }
  }
}

码头工人

docker build -t ovirt-engine-mcp-server .
docker run -e OVIRT_ENGINE_URL=https://ovirt-engine.example.com \
           -e OVIRT_ENGINE_USER=admin@internal \
           -e OVIRT_ENGINE_PASSWORD=your-password \
           ovirt-engine-mcp-server

可用工具

虚拟机（核心）

VM扩展操作

VM池

VM检查点

快照

磁盘（核心）

磁盘（扩展）

网络（核心）

VNIC配置文件

网络过滤器和QoS

主持人（核心）

主机（扩展）

集群（核心）

CPU配置文件

数据中心

存储（核心）

存储（扩展）

模板（核心）

模板（扩展）

实例类型

亲和团体

亲和力标记物

事件

RBAC-用户

RBAC-组

RBAC-角色

RBAC-权限

RBAC-标签

配额

系统和作业

建筑

┌──────────────────────────────┐
│  MCP Client (Claude / etc.)  │
│         stdio (JSON-RPC)     │
└──────────────┬───────────────┘
               │
┌──────────────▼───────────────┐
│     MCP Server (server.py)   │
│                              │
│  ┌─────────────────────────┐ │
│  │  OvirtMCP (ovirt_mcp)   │ │  ← Core SDK wrapper
│  │  150+ methods            │ │
│  ├─────────────────────────┤ │
│  │  Extension Modules      │ │
│  │  - NetworkMCP           │ │
│  │  - ClusterMCP           │ │
│  │  - TemplateMCP          │ │
│  │  - DataCenterMCP        │ │
│  │  - HostExtendedMCP      │ │
│  │  - StorageExtendedMCP   │ │
│  │  - DiskExtendedMCP      │ │
│  │  - EventsMCP            │ │
│  │  - AffinityMCP          │ │
│  │  - RbacMCP              │ │
│  │  - VmExtendedMCP        │ │
│  │  - TemplateExtendedMCP  │ │
│  │  - QuotaMCP             │ │
│  │  - SystemMCP            │ │
│  └─────────────────────────┘ │
└──────────────┬───────────────┘
               │
┌──────────────▼───────────────┐
│     oVirt Engine REST API    │
└──────────────────────────────┘

发展

# Install dev dependencies
pip install -e ".[dev]"

# Run tests
pytest tests/ -v

# Lint
ruff check src/ tests/

需求

• Python>=3.10
• oVirt发动机4.4+

许可证

MIT许可证——见 许可证 了解详情。

作者

马(@imjoey)

相关项目

• oVirt --开源虚拟化管理
• ovirtsdk4 --官方oVirt Python SDK
• 模型上下文协议 --MCP规范