ProxmoxMCP-Plus — MCP-сервер для Claude Code: Proxmox VE из агента
Даёт агенту доступ к Proxmox VE: виртуалки, LXC, снапшоты, бэкапы, ISO и кластер. Пригодится, когда рутина с гипервизором идёт через чат.
claude mcp add --env PROXMOX_MCP_CONFIG=<PROXMOX_MCP_CONFIG> --env PROXMOX_HOST=<PROXMOX_HOST> --env PROXMOX_USER=<PROXMOX_USER> --env PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME> --env PROXMOX_TOKEN_VALUE=<PROXMOX_TOKEN_VALUE> --transport stdio proxmoxmcp-plus -- uvx proxmox-mcp-plusЧто делает ProxmoxMCP-Plus
Сервер стоит между MCP-клиентом и Proxmox VE. Агент получает инструменты для жизненного цикла VM и LXC, работы со снапшотами, бэкапами и восстановлением, скачивания и очистки ISO, осмотра узлов, хранилищ и кластера. Долгие задачи Proxmox отслеживаются через job_id и UPID: опрос, повтор, отмена, история. Те же операции доступны по OpenAPI — для скриптов и дашбордов.
Перед запуском нужен API-токен Proxmox с правами под ваши сценарии и файл proxmox-config/config.json с полями proxmox.host, proxmox.port, auth.user, auth.token_name, auth.token_value. Для команд внутри контейнеров добавляется секция ssh. Без корректного токена сервер не поднимется, а неизвестное имя инструмента в фильтре обрушит старт — опечатка не расширит доступ молча.
Запуск локально: uvx proxmox-mcp-plus. Есть Docker-профили для MCP HTTP и OpenAPI, порты по умолчанию публикуются на 127.0.0.1. Фильтрация инструментов выключена, пока вы не зададите tool_allowlist или tool_denylist; после смены фильтра сервер надо перезапустить.
Какие задачи решает
- создать VM или LXC и довести её до рабочего состояния
- откатить снапшот перед рискованным обновлением
- сделать бэкап и восстановить из него
- скачать ISO и убрать старые образы
- выполнить команду внутри контейнера по SSH
Примеры запросов агенту
- Покажи список узлов и виртуалок в кластере
- Сделай снапшот VM 101 перед обновлением
- Запусти бэкап контейнера 204 и покажи статус задачи
Как установить ProxmoxMCP-Plus
Командой платформы
claude mcp add --env PROXMOX_MCP_CONFIG=<PROXMOX_MCP_CONFIG> --env PROXMOX_HOST=<PROXMOX_HOST> --env PROXMOX_USER=<PROXMOX_USER> --env PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME> --env PROXMOX_TOKEN_VALUE=<PROXMOX_TOKEN_VALUE> --transport stdio proxmoxmcp-plus -- uvx proxmox-mcp-plusВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from proxmox-mcp-plus <команда>
Командой платформы
codex mcp add proxmoxmcp-plus --env PROXMOX_MCP_CONFIG=<PROXMOX_MCP_CONFIG> --env PROXMOX_HOST=<PROXMOX_HOST> --env PROXMOX_USER=<PROXMOX_USER> --env PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME> --env PROXMOX_TOKEN_VALUE=<PROXMOX_TOKEN_VALUE> -- uvx proxmox-mcp-plusВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from proxmox-mcp-plus <команда>
Файл настроек
{
"mcpServers": {
"proxmoxmcp-plus": {
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_MCP_CONFIG": "<PROXMOX_MCP_CONFIG>",
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from proxmox-mcp-plus <команда>
Файл настроек
{
"servers": {
"proxmoxmcp-plus": {
"type": "stdio",
"command": "uvx",
"args": [
"proxmox-mcp-plus"
],
"env": {
"PROXMOX_MCP_CONFIG": "<PROXMOX_MCP_CONFIG>",
"PROXMOX_HOST": "<PROXMOX_HOST>",
"PROXMOX_USER": "<PROXMOX_USER>",
"PROXMOX_TOKEN_NAME": "<PROXMOX_TOKEN_NAME>",
"PROXMOX_TOKEN_VALUE": "<PROXMOX_TOKEN_VALUE>"
}
}
}
}Вместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from proxmox-mcp-plus <команда>
Командой платформы
gemini mcp add -e PROXMOX_MCP_CONFIG=<PROXMOX_MCP_CONFIG> -e PROXMOX_HOST=<PROXMOX_HOST> -e PROXMOX_USER=<PROXMOX_USER> -e PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME> -e PROXMOX_TOKEN_VALUE=<PROXMOX_TOKEN_VALUE> proxmoxmcp-plus uvx proxmox-mcp-plusВместо <…> подставьте свои значения. Ещё 7 переменных окружения — в README сервера. uvx запускает команду с именем пакета; если в README она другая — uvx --from proxmox-mcp-plus <команда>
По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Похожие
Рядом в теме «DevOps и инфраструктура»
Все MCP-серверы по теме «DevOps и инфраструктура» →Вопросы о ProxmoxMCP-Plus
Как установить ProxmoxMCP-Plus в Claude Code?
Одной командой: `claude mcp add proxmox-mcp-plus -e PROXMOX_HOST=<PROXMOX_HOST> -e PROXMOX_USER=<PROXMOX_USER> -e PROXMOX_TOKEN_NAME=<PROXMOX_TOKEN_NAME> -e PROXMOX_TOKEN_VALUE=<PROXMOX_TOKEN_VALUE> -- uvx proxmox-mcp-plus`. Подставьте адрес Proxmox, пользователя и данные токена.
Что делает ProxmoxMCP-Plus?
Открывает агенту операции Proxmox VE: VM и LXC, снапшоты, бэкапы, ISO, осмотр узлов и хранилищ. Долгие задачи отслеживаются по job_id и UPID.
Что нужно для работы сервера?
API-токен Proxmox с нужными правами и файл proxmox-config/config.json с хостом, портом и данными токена. Для команд внутри контейнеров добавьте секцию ssh.
