Proximo — the Proxmox MCP: MCP-сервер для Claude Code
MCP-сервер для администрирования Proxmox VE, PBS, PMG и PDM через языковые модели. Защищает инфраструктуру: сначала показывает план и радиус изменений, а затем выполняет команду.
claude mcp add proximo-proxmox -- uvx proximo-proxmoxЧто делает Proximo — the Proxmox MCP you can hand the keys
Сервер связывает ИИ-агентов с API четырёх продуктов линейки Proxmox: гипервизора PVE, сервера резервного копирования PBS, почтового шлюза PMG и менеджера дата-центров PDM. Архитектура не плодит десятки отдельных вызовов под каждый эндпоинт. Внутри всего шесть базовых инструментов, поэтому схема легко умещается даже в контекст небольших локальных моделей.
Безопасность заложена в саму механику работы. По умолчанию сервер доступен только для чтения. При попытке внести изменения инструмент не применяет их вслепую, а возвращает расчёт радиуса поражения и точный план правок. Перед опасными операциями внутри контейнеров сервер требует создать снимок состояния. Без снимка команда просто отклоняется.
Каждое действие фиксируется в защищённом журнале с квитанциями. Исходное состояние сохраняется до мутации, поэтому конфигурацию можно вернуть назад штатными средствами API. Без установленного Python 3.12+ запустить сервер через uvx не удастся. Телеметрии нет: трафик остаётся строго в вашем контуре.
Какие задачи решает
- диагностировать сбои в работе контейнеров и виртуальных машин
- согласовывать план изменений перед отправкой мутаций в API Proxmox
- создавать снимки гостевых систем перед выполнением опасных команд
- откатывать настройки узлов к состоянию до вмешательства агента
Примеры запросов агенту
- Выясни причину высокой нагрузки на контейнер 105 и проверь системные логи
- Подготовь план перезапуска виртуальной машины 200 со снимком состояния перед выключением
- Покажи квитанцию последней мутации в PVE и верни конфигурацию сети назад
Как установить Proximo — the Proxmox MCP you can hand the keys
Командой платформы
claude mcp add proximo-proxmox -- uvx proximo-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>
Командой платформы
codex mcp add proximo-the-proxmox-mcp-you-can-hand-the-keys -- uvx proximo-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>
Файл настроек
{
"mcpServers": {
"proximo-the-proxmox-mcp-you-can-hand-the-keys": {
"command": "uvx",
"args": [
"proximo-proxmox"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>
Файл настроек
{
"servers": {
"proximo-the-proxmox-mcp-you-can-hand-the-keys": {
"type": "stdio",
"command": "uvx",
"args": [
"proximo-proxmox"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>
Командой платформы
gemini mcp add proximo-the-proxmox-mcp-you-can-hand-the-keys uvx proximo-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Proximo — the Proxmox MCP you can hand the keys
Как установить Proximo в Claude Code?
Выполните команду claude mcp add proximo-proxmox -- uvx proximo-proxmox. Для запуска требуется установленный Python 3.12 или новее с утилитой uvx.
Чем Proximo отличается от прямого доступа к API Proxmox?
Сервер по умолчанию работает только на чтение и не применяет правки без предварительного плана. Он рассчитывает радиус изменений, делает снимки перед вмешательством и сохраняет квитанцию для отката.
Какие продукты Proxmox поддерживает сервер?
Поддерживается вся линейка: Proxmox Virtual Environment (VE), Backup Server (PBS), Mail Gateway (PMG) и Datacenter Manager (PDM).
