Proxmox Safe MCP

Сфокусированный Proxmox MCP сервер, предоставляющий ограниченные операции чтения инвентаря/статуса и только два узких класса мутаций: разрешённые действия с питанием гостевых систем и создание снимков. Извлечено из коммита spectrenet-mcp 2e63f009d8f4642e17398685baef0251811d6637; этот репозиторий самодостаточен.

Альфа: тесты синтетические. Совместимость с Proxmox API не сертифицирована для каждого релиза; тестируйте на непродакшн-инфраструктуре.

Контракт безопасности

• Узлы явно внесены в белый список для операций, нацеленных на узлы (node_status), и обоих инструментов мутаций; типы гостевых систем — только qemu и lxc; VMID должны быть положительными целыми числами.

• cluster_status и list_guests намеренно возвращают представления API на уровне кластера и не фильтруются по белому списку узлов. Ограничьте выделенную учётную запись/токен Proxmox API, чтобы ограничить, что могут видеть эти инструменты чтения.

• Действия с питанием — только start, shutdown, reboot и stop.

• Имена снимков — 1–64 буквы ASCII, цифры, _ или -.

• Каждая мутация требует подтверждения APPROVE <action> <target> байт-в-байт.

• Ответы на мутации — это квитанции о приёме, а не доказательство завершения. Проверяйте возвращённый UPID и конечное состояние отдельно.

• Нет инструментов для удаления гостевых систем/снимков, управления питанием хоста, изменения хранилища, выделения ресурсов, миграции или конфигурации. node_status намеренно исключает перечисление хранилища.

• Ответы/списки/поля аудита ограничены, а проверка TLS включена по умолчанию.

Related MCP server: ProxmoxMCP-Plus

Установка и запуск

uv sync --extra test
uv run proxmox-safe-mcp --help
uv run proxmox-safe-mcp

Сервер использует MCP stdio. Он не загружает .env; используйте .env.example только как фиктивную документацию и внедряйте секреты через супервизор или менеджер секретов.

Проверка

uv sync --locked --extra test
uv run --locked pytest
uv run --locked python -m compileall -q src tests
uv build

См. архитектуру и операции и детали безопасности. MIT © 2026 Ben Gauger.