Proxmox MCP — MCP-сервер для Claude Code: доступ к Proxmox VE
Подключает ИИ-ассистента к API Proxmox VE: списки кластеров, узлов, хранилищ, контейнеров и виртуальных машин. Пригодится, когда надоело щёлкать по страницам веб-интерфейса.
claude mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0Что делает Proxmox MCP is an opinionated MCP server
Сервер соединяет MCP-клиента с API Proxmox VE и поддерживает несколько кластеров сразу, возвращая структурированные данные. Инструменты по умолчанию только читают: proxmox_clusters_list, proxmox_clusters_describe, proxmox_nodes_list, proxmox_nodes_describe, proxmox_storage_list, proxmox_storage_describe, proxmox_vms_list, proxmox_vms_describe, proxmox_containers_list, proxmox_containers_describe, proxmox_events_list. Начинать стоит с proxmox_clusters_list — остальные инструменты принимают имя кластера из него.
Действия вроде бэкапов и перезагрузок включаются флагом --allow-destructive: тогда появляются proxmox_vms_backup и proxmox_containers_backup. Они запускают асинхронную задачу и возвращают её идентификатор — создание задачи не значит, что бэкап уже прошёл. Изменения инфраструктуры сервер не заменяет: Terraform, Ansible и GitOps остаются основным способом что-то менять.
Перед запуском нужен YAML-файл с кластерами: обязательны region и url с /api2/json, плюс либо токен (token_id и token_secret или их файловые варианты), либо пара username и password. Смешивать оба способа входа в одном кластере нельзя. Путь задаётся через --config или переменную CONFIG_FILE. У HTTP-эндпоинта своей аутентификации нет — доступ держится на токенах Proxmox, а токен передаётся заголовком Authorization.
Какие задачи решает
- посмотреть состояние узлов и кластеров без захода в веб-интерфейс
- собрать список LXC-контейнеров с их потреблением ресурсов
- проверить занятость хранилищ и их тип
- разобрать недавние задачи Proxmox по всем узлам
- сверить конфигурацию перед изменениями в инфраструктуре
Примеры запросов агенту
- Покажи список кластеров Proxmox и состояние узлов в homelab
- Какие виртуальные машины сейчас работают и сколько ресурсов они занимают?
- Выведи последние задачи по кластеру homelab
Как установить Proxmox MCP is an opinionated MCP server
Командой платформы
claude mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0Командой платформы
codex mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0Файл настроек
{
"mcpServers": {
"proxmox-mcp-is-an-opinionated-mcp-server": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0"
]
}
}
}Файл настроек
{
"servers": {
"proxmox-mcp-is-an-opinionated-mcp-server": {
"type": "stdio",
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0"
]
}
}
}Командой платформы
gemini mcp add proxmox-mcp-is-an-opinionated-mcp-server docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0По шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о Proxmox MCP is an opinionated MCP server
Как установить Proxmox MCP в Claude Code?
Выполните claude mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0. Для локальной установки без Docker есть brew install sergelogvinov/tap/proxmox-mcp.
Что делает Proxmox MCP?
Даёт ИИ-ассистенту доступ к API Proxmox VE: списки и описания кластеров, узлов, хранилищ, контейнеров и виртуальных машин, а также недавние задачи. По умолчанию все инструменты только читают.
Как включить бэкапы и перезагрузки?
Запустите сервер с флагом --allow-destructive — тогда добавятся proxmox_vms_backup и proxmox_containers_backup. Они стартуют асинхронную задачу и возвращают её идентификатор, а не результат завершения.
