Proximo — управление Proxmox через агента с журналом
Proximo
MCP-сервер для Proxmox VE, Backup Server, Mail Gateway и Datacenter Manager: план до действия, журнал изменений и откат
- 94 ★ репозитория
- Последний коммит
- AGPL-3.0
Широкий доступ
Почему такой уровень
- Агент получает управление виртуальными машинами и контейнерами, включая остановку, миграцию и удаление
- Опциональные каналы выполняют команды внутри контейнера и на узле
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/proximoОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемШирокий доступИнструмент может менять данные, выполнять команды или работать с секретами.
- Агент получает управление виртуальными машинами и контейнерами, включая остановку, миграцию и удаление
- Опциональные каналы выполняют команды внутри контейнера и на узле
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Proximo дает агенту управление Proxmox через шесть инструментов, которые покрывают все адреса API четырех продуктов: Proxmox VE, Proxmox Backup Server, Proxmox Mail Gateway и Proxmox Datacenter Manager. По описанию автора это 1804 опубликованных адреса, из них 884 чтения и 785 изменений. Сервер по умолчанию работает на чтение. Любое изменение сначала возвращает план: вердикт, текущее состояние цели и точную правку. Затем нужен вызов с `confirm=true`, взведенный доступ и уровень последствий. Каждое действие попадает в журнал с защитой от подделки, который проверяет `audit_verify`. Где платформа дает такую возможность, перед изменением запоминается прежняя запись, и откат возвращается через собственную запись вендора. Есть необязательные каналы с отдельными переключателями и списками разрешенных команд: выполнение команды внутри контейнера и на узле через ssh и `pct exec`. Проверку токена выполняет `uvx proximo-proxmox doctor`. Работает локально, без облака и телеметрии.
Для кого. Администраторам домашних лабораторий и серверных на Proxmox, которые хотят поручить агенту диагностику и правки и сохранить журнал каждого шага.
Подходит, если
- Контейнер тормозит, и агент должен прочитать статус узла, логи и состояние гостя
- Нужно увидеть план остановки или миграции гостя до его выполнения
- Перед правкой настроек важно сохранить снимок и иметь откат
- Требуется проверить, что журнал действий агента не подделан
Не подходит, если
- Нужна оркестрация Kubernetes или облачных ВМ: сервер работает только с четырьмя продуктами Proxmox
- Нет возможности создать токен с ограниченными правами: без него безопасный режим теряет смысл
- Нужны правки без плана и подтверждения: каждое изменение идет через оба шага
Пример запроса к агенту
Почему контейнер 105 тормозит? Прочитай статус узла и логи, а если нужна правка, покажи план и ничего не меняй до моего ответа.MCP
- Транспорт
- stdio, http
- Авторизация
- API-ключ
Переменные окружения
PROXIMO_API_BASE_URLобязательная- Адрес API Proxmox, например https://pve:8006/api2/json
PROXIMO_TOKEN_PATHобязательная, секрет- Путь к файлу токена в виде USER@REALM!TOKENID=SECRET
Ограничения
Нужен доступ к API Proxmox по токену и Python для запуска через `uvx`, клиент должен ждать старта около 3,5 секунды: ставьте тайм-аут 60 секунд, иначе клиент по умолчанию может молча отбросить сервер. Начинайте с токена на чтение: сервер полезен и без прав на запись.
Откат есть там, где платформа дает примитив записи, но не для всех изменений. С версии 0.51.0 лицензия AGPL-3.0-or-later. Каналы оболочки и выполнения команд выключены, пока их не включит оператор, и судятся как любое изменение. Заявления автора о защите и проверках стоит сверять с файлом `VERIFY.md` в репозитории.
Как отключить. Удалите сервер командой `claude mcp remove proximo` и отзовите токен в Proxmox. Журнал и память об узлах остаются в файлах на вашей машине рядом с журналом, их удаляют вручную.
Частые вопросы
Как подключить Proximo к Claude Code?
Выполните `claude mcp add proximo` с переменными `PROXIMO_API_BASE_URL` и `PROXIMO_TOKEN_PATH`, команда запуска `uvx proximo-proxmox`. Секрет хранится в файле, в конфигурацию клиента попадает только путь.
Может ли агент что-то изменить без моего подтверждения?
Нет. Изменение сначала возвращает план, а выполняется только с `confirm=true`, взведенным доступом и уровнем последствий. На чтение изменения не нужны.
Какие продукты Proxmox поддерживаются?
Proxmox VE, Proxmox Backup Server, Proxmox Mail Gateway и Proxmox Datacenter Manager.
Как откатить изменение?
Командой `proximo_call pve undo <id>`: сервер записывает прежнюю запись обратно через собственную запись вендора. Откат есть не для всех изменений.
Как получить токен с минимальными правами?
Команда `uvx proximo-proxmox mint pve` печатает инструкцию по токену с наименьшими правами. Проверить, что токен может, помогает `doctor`.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер Proxmox VE с 341 инструментом: виртуальные машины, контейнеры, хранилища, кластер и бэкапы, с режимом только чтения.
MCP-сервер для Proxmox VE: управление виртуалками, LXC, снапшотами и бэкапами из агента с контролем прав и одобрением команд
Модуль PowerShell и навык для Claude Code и Codex: агент находит, запускает и снимает снимки виртуальных машин Proxmox VE по API.
Самохостящийся хаб для домашней лаборатории со встроенным MCP-сервером: у агента 32 инструмента с правами по ключам API
CLI на Go сравнивает сервер с прошлым снимком, сообщает только значимые перемены и отдает их агенту через MCP
Официальный MCP-сервер Prometheus: PromQL-запросы, метрики, правила и оповещения плюс встроенные runbook для разбора проблем.
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Proximo — управление Proxmox через агента с журналом (эта карточка) | нет | API-ключ | 94 | |
| ProxmoxMCP-Plus | нет | ключ необязателен | 649 | MCP для Proxmox без журнала с защитой от подделки и плана перед изменением |
| NetBox MCP Server | да | API-ключ | 255 | инвентарь сети NetBox без управления гипервизором |
Коротко о README
README подробно объясняет идею доверительного слоя: план, доказательство, откат и диагностика включены по умолчанию, а согласие и ограничения выбирает оператор. Далее идут быстрый старт, таблица поверхностей и инструментов, установка и запуск, отдельный файл проверки `VERIFY.md` и описание версий вплоть до 0.52.0.