# Proxmox MCP is an opinionated MCP server

Подключает ИИ-ассистента к API Proxmox VE: списки кластеров, узлов, хранилищ, контейнеров и виртуальных машин. Пригодится, когда надоело щёлкать по страницам веб-интерфейса.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Автор: sergelogvinov
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/sergelogvinov/proxmox-mcp
- Обновлён: 2026-10-05
- HTML: https://affpapa.org/nevibecode/mcp/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`.

## Требования
- Нужно: Docker

## Установка

### Claude Code (родная платформа)

**Командой платформы**
```bash
claude mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0
```

### Codex

**Командой платформы**
```bash
codex mcp add proxmox-mcp-is-an-opinionated-mcp-server -- docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0
```

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "proxmox-mcp-is-an-opinionated-mcp-server": {
            "command": "docker",
            "args": [
                "run",
                "-i",
                "--rm",
                "ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0"
            ]
        }
    }
}
```

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "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 CLI

**Командой платформы**
```bash
gemini mcp add proxmox-mcp-is-an-opinionated-mcp-server docker run -i --rm ghcr.io/sergelogvinov/proxmox-mcp:v0.3.0
```

## Когда брать
- посмотреть состояние узлов и кластеров без захода в веб-интерфейс
- собрать список LXC-контейнеров с их потреблением ресурсов
- проверить занятость хранилищ и их тип
- разобрать недавние задачи Proxmox по всем узлам
- сверить конфигурацию перед изменениями в инфраструктуре

## Примеры запросов агенту
- Покажи список кластеров Proxmox и состояние узлов в homelab
- Какие виртуальные машины сейчас работают и сколько ресурсов они занимают?
- Выведи последние задачи по кластеру homelab

## Похожие
- [Proxmox VE](https://affpapa.org/nevibecode/mcp/proxmox-ve.md) — MCP-сервер · ★ 5
- [proxmox-admin](https://affpapa.org/nevibecode/skills/proxmox-admin.md) — скилл · 828 установок
- [Proximo — the Proxmox MCP you can hand the keys](https://affpapa.org/nevibecode/mcp/proximo-the-proxmox-mcp-you-can-hand-the-keys.md) — MCP-сервер · ★ 61
- [mcp-proxmox](https://affpapa.org/nevibecode/mcp/mcp-proxmox.md) — MCP-сервер · ★ 17
- [Proxmox MCP](https://affpapa.org/nevibecode/mcp/proxmox-mcp.md) — MCP-сервер · ★ 63
- [ProxmoxMCP-Plus](https://affpapa.org/nevibecode/mcp/proxmoxmcp-plus.md) — MCP-сервер · ★ 620

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md