# Proximo — the Proxmox MCP you can hand the keys

MCP-сервер для администрирования Proxmox VE, PBS, PMG и PDM через языковые модели. Защищает инфраструктуру: сначала показывает план и радиус изменений, а затем выполняет команду.

- MCP-сервер · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 58
- Автор: john-broadway
- Лицензия: Apache-2.0 · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/john-broadway/proximo
- Обновлён: 2026-10-22
- HTML: https://affpapa.org/nevibecode/mcp/proximo-the-proxmox-mcp-you-can-hand-the-keys

## Что делает

Сервер связывает ИИ-агентов с API четырёх продуктов линейки Proxmox: гипервизора PVE, сервера резервного копирования PBS, почтового шлюза PMG и менеджера дата-центров PDM. Архитектура не плодит десятки отдельных вызовов под каждый эндпоинт. Внутри всего шесть базовых инструментов, поэтому схема легко умещается даже в контекст небольших локальных моделей.

Безопасность заложена в саму механику работы. По умолчанию сервер доступен только для чтения. При попытке внести изменения инструмент не применяет их вслепую, а возвращает расчёт радиуса поражения и точный план правок. Перед опасными операциями внутри контейнеров сервер требует создать снимок состояния. Без снимка команда просто отклоняется.

Каждое действие фиксируется в защищённом журнале с квитанциями. Исходное состояние сохраняется до мутации, поэтому конфигурацию можно вернуть назад штатными средствами API. Без установленного Python 3.12+ запустить сервер через `uvx` не удастся. Телеметрии нет: трафик остаётся строго в вашем контуре.

## Требования
- Нужно: Python и uv (команды через uvx)

## Установка

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

**Командой платформы**
```bash
claude mcp add proximo-proxmox -- uvx proximo-proxmox
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>

### Codex

**Командой платформы**
```bash
codex mcp add proximo-the-proxmox-mcp-you-can-hand-the-keys -- uvx proximo-proxmox
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>

### Cursor

**Файл настроек**
Файл `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "proximo-the-proxmox-mcp-you-can-hand-the-keys": {
            "command": "uvx",
            "args": [
                "proximo-proxmox"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>

### GitHub Copilot

**Файл настроек**
Файл `.vscode/mcp.json`:
```json
{
    "servers": {
        "proximo-the-proxmox-mcp-you-can-hand-the-keys": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "proximo-proxmox"
            ]
        }
    }
}
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>

### Gemini CLI

**Командой платформы**
```bash
gemini mcp add proximo-the-proxmox-mcp-you-can-hand-the-keys uvx proximo-proxmox
```
uvx запускает команду с именем пакета; если в README она другая — uvx --from proximo-proxmox <команда>

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

## Примеры запросов агенту
- Выясни причину высокой нагрузки на контейнер 105 и проверь системные логи
- Подготовь план перезапуска виртуальной машины 200 со снимком состояния перед выключением
- Покажи квитанцию последней мутации в PVE и верни конфигурацию сети назад

## Похожие
- [GitHub](https://affpapa.org/nevibecode/mcp/github.md) — MCP-сервер · ★ 33918
- [Netdata](https://affpapa.org/nevibecode/mcp/netdata.md) — MCP-сервер · ★ 81115
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [Keploy](https://affpapa.org/nevibecode/mcp/keploy.md) — MCP-сервер · ★ 18727
- [Coder](https://affpapa.org/nevibecode/mcp/coder.md) — MCP-сервер · ★ 17160
- [mcp](https://affpapa.org/nevibecode/mcp/kubeshark-mcp.md) — MCP-сервер · ★ 12109

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