ProxmoxMCP-Plus

ProxmoxMCP-Plus

RekklesNAMIT
228 звёзд56 форков
ProxmoxMCP-Plus — это управляющая прослойка между AI-ассистентами и гипервизором Proxmox VE. Вместо того чтобы вручную дёргать API, писать shell-скрипты и отслеживать очереди задач, инженер поручает это агенту. Сервер берёт на себя авторизацию через API-токены, выполнение команд внутри контейнеров через SSH с ограничениями, а также мониторинг долгих асинхронных задач. ProxmoxMCP-Plus одновременно работает как MCP-сервер и как OpenAPI-сервер. Это значит, что одну операцию — например, создание снапшота — можно выполнить через текстовый запрос в Claude Desktop или через HTTP-запрос из внутренней автоматизации. Ядро логики и модель безопасности едины.
Files
Открыть на GitHubОфициальный сайт

Установка

uvx proxmox-mcp-plus

Характеристики

Общее

  • СтатусСообщество
  • РазработчикRekklesNA
  • ЛицензияMIT

Технологии

  • Языки
    Python
  • Транспорт
    stdio

Описание

Возможности

  • Управление жизненным циклом виртуальных машин и LXC-контейнеров: создание, запуск, остановка, миграция, удаление.
  • Создание, откат и удаление снапшотов для ВМ и контейнеров.
  • Запуск резервного копирования и восстановление из бэкапов.
  • Загрузка ISO-образов на хранилища Proxmox и их удаление.
  • Инспекция узлов кластера, хранилищ (Ceph, ZFS, LVM) и конфигурации.
  • Выполнение команд внутри LXC-контейнеров через SSH с гибкими ограничениями.
  • Отслеживание долгих асинхронных задач Proxmox и получение их статуса.

Как подключить

Установите сервер через uvx proxmox-mcp-plus или pip install proxmox-mcp-plus.

Создайте API-токен в веб-интерфейсе Proxmox (Datacenter → Permissions → API Tokens). Запишите имя токена и секретное значение.

Добавьте конфигурацию в файл настроек вашего MCP-клиента. Пример для Claude Desktop:

{ "mcpServers": { "proxmox": { "command": "uvx", "args": ["proxmox-mcp-plus"], "env": { "PROXMOX_HOST": "https://ваш-сервер:8006", "PROXMOX_TOKEN_NAME": "пользователь@pam!id-токена", "PROXMOX_TOKEN_VALUE": "секретное-значение-токена" } } } }

Перезагрузите клиент MCP. В списке инструментов появятся операции для работы с Proxmox VE.

Примеры запросов

  • «Покажи список всех ВМ на узле pve-01 и их статус».
  • «Создай снапшот для контейнера 200 с комментарием "Перед обновлением пакетов"».
  • «Запусти резервное копирование ВМ 105 в хранилище vzdump-backup и покажи статус задачи».
  • «Выполни команду df -h в контейнере 150 и выведи результат».
  • «Найди ВМ с максимальной загрузкой CPU за последний час».

Технические детали

  • Язык разработки: Python 3.10+
  • Транспорт: stdio (MCP), HTTP/REST (OpenAPI)
  • Лицензия: MIT
  • Разработчик: RekklesNA
  • Звёзд на GitHub: 228
  • Совместимые клиенты: MCP (Claude Desktop, Cursor, VS Code, Open WebUI, Codex), OpenAPI (Postman, n8n, внутренние дашборды)

Поделиться