mcp-proxmox — MCP-сервер для Claude Code: что делает и как установить
Подключает AI-ассистента к Proxmox VE для управления виртуальными машинами, контейнерами, хранилищами и снапшотами. Нужен для работы с инфраструктурой через запросы.
claude mcp add mcp-proxmox -- uvx mcp-proxmoxЧто делает mcp-proxmox
mcp-proxmox даёт AI-ассистенту инструменты для работы с кластерами Proxmox VE. Через запросы можно просматривать узлы, виртуальные машины QEMU и LXC-контейнеры, запускать и останавливать гостевые системы, создавать клоны, бэкапы и снапшоты, управлять хранилищами и сетями.
Сервер запускается через uvx mcp-proxmox или после установки пакета командой pip install mcp-proxmox. Для подключения нужны PROXMOX_HOST, PROXMOX_TOKEN_ID и PROXMOX_TOKEN_SECRET; порт и проверка SSL задаются через PROXMOX_PORT и PROXMOX_VERIFY_SSL. Токен создаётся в Proxmox VE и получает права вроде VM.Audit, VM.PowerMgmt и Datastore.Audit.
Команда exec_command работает только с QEMU VM, где установлен и запущен qemu-guest-agent, поэтому для LXC-контейнеров она не подойдёт. Инструменты консоли используют права VM.Console; отправка текста рассчитана на раскладку US и не поддерживает кириллицу.
Какие задачи решает
- просматривать узлы и статус гостевых систем
- создавать и клонировать VM и LXC-контейнеры
- делать бэкапы и откатывать снапшоты
- управлять хранилищами, сетями и firewall
- запускать команды внутри QEMU VM
Примеры запросов агенту
- Покажи узлы кластера Proxmox и их загрузку CPU и памяти.
- Создай QEMU VM с нужными CPU, памятью, диском и сетевым подключением.
- Сделай снапшот VM, а затем покажи последние задачи Proxmox.
Как установить mcp-proxmox
Командой платформы
claude mcp add mcp-proxmox -- uvx mcp-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-proxmox <команда>
Командой платформы
codex mcp add mcp-proxmox -- uvx mcp-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-proxmox <команда>
Файл настроек
{
"mcpServers": {
"mcp-proxmox": {
"command": "uvx",
"args": [
"mcp-proxmox"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-proxmox <команда>
Файл настроек
{
"servers": {
"mcp-proxmox": {
"type": "stdio",
"command": "uvx",
"args": [
"mcp-proxmox"
]
}
}
}uvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-proxmox <команда>
Командой платформы
gemini mcp add mcp-proxmox uvx mcp-proxmoxuvx запускает команду с именем пакета; если в README она другая — uvx --from mcp-proxmox <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о mcp-proxmox
Как установить mcp-proxmox в Claude Code?
Выполните claude mcp add mcp-proxmox -- uvx mcp-proxmox, затем настройте переменные PROXMOX_HOST, PROXMOX_TOKEN_ID и PROXMOX_TOKEN_SECRET.
Что делает mcp-proxmox?
Он подключает AI-ассистента к Proxmox VE и даёт инструменты для управления VM, LXC-контейнерами, снапшотами, бэкапами, хранилищами и сетями.
Можно ли выполнять команды внутри LXC-контейнера?
Нет. exec_command работает через qemu-guest-agent и поддерживает только QEMU VM.
