ProxmoxMCP-Plus

ProxmoxMCP-Plus

RekklesNAv0.7.2MIT
664 звёзд104 форков
ProxmoxMCP-Plus — это управляющая прослойка между AI-ассистентами и гипервизором Proxmox VE. Вместо того чтобы вручную дёргать API, писать shell-скрипты и отслеживать очереди задач, инженер поручает это агенту. Сервер берёт на себя авторизацию через API-токены, выполнение команд внутри контейнеров через SSH с ограничениями, а также мониторинг долгих асинхронных задач. ProxmoxMCP-Plus одновременно работает как MCP-сервер и как OpenAPI-сервер. Это значит, что одну операцию — например, создание снапшота — можно выполнить через текстовый запрос в Claude Desktop или через HTTP-запрос из внутренней автоматизации. Ядро логики и модель безопасности едины.
  • Сервер сообщества
  • Локальный запуск (stdio)
  • Python
  • Лицензия MIT
  • Обновлён 18 ноября 2026 г.
Подключение

Подключить ProxmoxMCP-Plus

Выберите способ запуска и свой MCP-клиент. Ниже останется одна готовая инструкция, которую можно проверить и скопировать.

1

Способ подключения

2

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

3

Скопируйте и проверьте

Claude Desktop / Claude Code

Локальный MCP-сервер запускается этой командой из конфигурации выбранного клиента.

  1. 1.Откройте настройки MCP в Claude.
  2. 2.Добавьте сервер с указанной командой и переменными окружения.
  3. 3.Перезапустите Claude, если сервер не появился автоматически.
json
{
  "mcpServers": {
    "proxmox-mcp-plus": {
      "command": "uvx",
      "args": [
        "proxmox-mcp-plus"
      ]
    }
  }
}

Перед подключением сверьте команду с README проекта, замените шаблонные токены и предоставьте только необходимые права доступа.

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

Общее

  • СтатусСообщество
  • РазработчикRekklesNA
  • Версияv0.7.2
  • ЛицензияMIT
  • Последний релиз18.11.2026
  • Активность источника18.11.2026

Технологии

  • Языки
    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, внутренние дашборды)

Поделиться