ProxmoxMCP-Plus
MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд
- 649 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Управляет боевой виртуализацией: виртуалки, LXC, снапшоты, бэкапы
- Требует API-токен Proxmox с правами на изменения
- Нативный MCP по HTTP при неверной настройке можно открыть без авторизации
Установка
- Работает в
Ручная установка
uvx proxmox-mcp-plusЗапуск MCP stdio из PyPI без установки в систему. Нужен uv.
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Управляет боевой виртуализацией: виртуалки, LXC, снапшоты, бэкапы
- Требует API-токен Proxmox с правами на изменения
- Нативный MCP по HTTP при неверной настройке можно открыть без авторизации
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер связывает Proxmox VE с агентами и HTTP-инструментами через единый слой управления. Он покрывает повседневные операции: работу с виртуальными машинами и LXC, снапшоты, бэкапы, ISO, хранилища и запросы к узлам кластера. Долгие задачи отслеживаются по стабильным идентификаторам job_id с привязкой к Proxmox UPID, есть опрос статуса, повтор, отмена и история. Доступны два пути: нативный MCP для агентов и мост OpenAPI для дашбордов и no-code сценариев. Ставится через uvx или pip с PyPI, либо запускается в docker.
Для кого. Для devops-инженеров и владельцев homelab, которые держат виртуализацию на Proxmox VE.
Подходит, если
- Нужно управлять виртуалками и LXC на Proxmox из агента
- Нужны снапшоты, бэкапы и работа с хранилищами по запросу
- Нужно отслеживать долгие задачи Proxmox с повтором и отменой
Не подходит, если
- Нет API-токена Proxmox с нужными правами
- Не хотите давать агенту доступ к боевой виртуализации
- Нужен только просмотр без риска изменяющих операций
Пример запроса к агенту
Покажи узлы и виртуалки Proxmox и сделай снапшот vm 101 перед обновлениемMCP
- Транспорт
- stdio, http, sse
- Авторизация
- ключ необязателен
Переменные окружения
MCP_API_KEYсекрет- Ключ для доступа к нативному MCP по HTTP, передается в заголовке Authorization и не связан с учеткой Proxmox
PROXMOX_MCP_MODE- Режим запуска сервера, например mcp-http для нативного MCP по HTTP
Ограничения
Нужен доступ к Proxmox VE и API-токен, права токена определяют, что сервер сможет делать. Конфигурация задается в файле proxmox-config/config.json с адресом узла и токеном. Для нативного MCP по HTTP требуется отдельный ключ MCP_API_KEY и заголовок Authorization с каждым запросом, иначе доступ надо явно открыть небезопасной опцией. Сервер выполняет изменяющие операции над инфраструктурой.
Как отключить. Удалите запись сервера из конфигурации MCP клиента, остановите контейнер docker, если он запущен, и отзовите API-токен Proxmox.
Частые вопросы
Чем нативный MCP отличается от OpenAPI?
Нативный MCP используют агенты. Мост OpenAPI дает те же операции по HTTP для дашбордов, скриптов и no-code инструментов.
Как настраивается доступ к Proxmox?
Через файл proxmox-config/config.json, где указывают адрес узла, порт и API-токен с нужными правами.
Чем ProxmoxMCP-Plus отличается от прямого вызова API Proxmox?
Сервер дает агенту единый слой управления Proxmox VE с контролем прав и одобрением команд. Он покрывает виртуальные машины и LXC, снапшоты, бэкапы, ISO и хранилища. Есть нативный MCP и HTTP-инструменты через OpenAPI.
Как настроить доступ к Proxmox для MCP?
Создайте в Proxmox отдельный токен API с минимальными правами и укажите его в конфиге. Запуск: uvx proxmox-mcp-plus. Работает с Claude Desktop, Cursor, VS Code и Codex. Риск высокий: сервер управляет виртуалками.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Proxmox VE с 341 инструментом: виртуальные машины, контейнеры, хранилища, кластер и бэкапы, с режимом только чтения.
MCP-сервер для Proxmox VE, Backup Server, Mail Gateway и Datacenter Manager: план до действия, журнал изменений и откат
Модуль PowerShell и навык для Claude Code и Codex: агент находит, запускает и снимает снимки виртуальных машин Proxmox VE по API.
Самохостящийся хаб для домашней лаборатории со встроенным MCP-сервером: у агента 32 инструмента с правами по ключам API
Самостоятельно размещаемый шлюз, который собирает несколько MCP-серверов в один эндпоинт с авторизацией и выбором инструментов
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| ProxmoxMCP-Plus (эта карточка) | нет | ключ необязателен | 649 | |
| kubectl-mcp-server | нет | не нужна | 972 | читает состояние кластера и разбирает сбои подов |
| Unreal Engine MCP Server | нет | не нужна | 1 032 | ассеты, акторы и блупринты Unreal Engine |
| Android MCP | нет | не нужна | 924 | управляет Android-устройством через ADB |
Коротко о README
README описывает управление Proxmox VE из MCP-клиентов, агентов и OpenAPI-инструментов с акцентом на безопасность: API-токены Proxmox, bearer-авторизация OpenAPI, политика команд, токены одобрения и проверка TLS. Показаны три пути запуска: MCP stdio через uvx proxmox-mcp-plus, нативный MCP по HTTP через docker compose и мост OpenAPI. Долгие операции отслеживаются по job_id и Proxmox UPID. Отдельно описан режим выполнения кода с тремя инструментами в изолированной песочнице. Лицензия MIT.