proxmox-mcp

proxmox-mcp — это защищённый локальный stdio-сервер для Model Context Protocol, работающий с API Proxmox VE. Он запускается как процесс MCP-хостом; это не HTTP-сервис, и он не предоставляет HTTP-эндпоинт.

Статус — текущий релиз: v0.1.1. Официальным дистрибутивом является архив GitHub Release и его SHA-256 контрольная сумма. npm-пакет не предоставляется и не публикуется.

Установка выпущенной версии Proxmox MCP

Для локальной установки stdio используйте архив GitHub Release с проверкой контрольной суммы:

• GitHub Release v0.1.1

• Архив

• Контрольная сумма

npm-пакета нет. Страница в LobeHub Marketplace описывает возможности; это не источник локальной установки. ClawHub в настоящее время не опубликован, так как общедоступная устанавливаемая обёртка/список OpenClaw недоступна.

Related MCP server: mcp-server-proxmox

Быстрая установка

Загрузите архив v0.1.1 и контрольную сумму с GitHub Releases, проверьте их и распакуйте архив. Выполните это на машине, где будет работать MCP-хост.

curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz
curl -fLO https://github.com/Theorvane/proxmox-mcp/releases/download/v0.1.1/proxmox-mcp-0.1.1.tar.gz.sha256
shasum -a 256 -c proxmox-mcp-0.1.1.tar.gz.sha256
tar -xzf proxmox-mcp-0.1.1.tar.gz
cd proxmox-mcp-0.1.1

Архиву требуется Node.js >=22. Передайте учётные данные через окружение; значения ниже являются заполнителями, а не рабочими учётными данными.

export PROXMOX_BASE_URL='https://proxmox.example:8006'
export PROXMOX_TOKEN_ID='user@realm!token-name'
: "${PROXMOX_TOKEN_SECRET:?set PROXMOX_TOKEN_SECRET in the environment}"
./proxmox-mcp

./proxmox-mcp — это stdio-процесс. Зарегистрируйте или настройте эту команду, её рабочий каталог и три переменные окружения в вашем MCP-хосте; запуск её в терминале сам по себе не делает её доступной для клиента. Информацию о структуре архива и деталях установки см. в руководстве по установке из GitHub Release.

Конфигурация

Используются только следующие переменные окружения:

Проверка сертификата TLS всегда включена. PROXMOX_TLS_VERIFY=false отклоняется при запуске; не используйте его. Если конечная точка Proxmox использует частный ЦС, доверьте этому ЦС в хранилище доверия хоста. Полную политику см. в конфигурации.

Возможности

Сервер предоставляет сфокусированный набор операций Proxmox VE. MCP-хосты обнаруживают точные схемы и описания инструментов при подключении.

Имена инструментов, входные и выходные данные, а также правила валидации имён узлов описаны в контракте инструментов.

Модель безопасности

Удаление, удаление неиспользуемых дисков и принудительная остановка могут быть необратимыми. Тщательно проверяйте цели и предоставляйте токену только те разрешения Proxmox, которые ему необходимы. Полное руководство по безопасности см. в документации по безопасности.

Локальный навык OpenClaw

В объединённой кодовой базе dev содержится навык OpenClaw в каталоге skills/proxmox-mcp-openclaw/. Это локальный навык, а не универсальный плагин OpenClaw. Используйте его локальные инструкции SKILL.md.

Выберите новый абсолютный целевой каталог — целевой каталог не должен существовать. Сначала просмотрите план без учётных данных:

node skills/proxmox-mcp-openclaw/scripts/install.mjs --dry-run /absolute/path/to/proxmox-mcp

После экспорта трёх переменных конфигурации в оболочку установите и зарегистрируйте его:

node skills/proxmox-mcp-openclaw/scripts/install.mjs /absolute/path/to/proxmox-mcp

Установщик проверяет неизменяемый релиз v0.1.1 и его контрольную сумму, а затем вызывает поддерживаемую команду openclaw mcp add только после успешной предварительной проверки. Он не регистрирует и не хранит учётные данные.

Границы эксплуатации

• Это локальная интеграция MCP через stdio, а не размещённый сервис или замена контроля доступа Proxmox.

• Сервер не отправляет запросы к Proxmox, пока клиент MCP не вызовет инструмент. Примеры установки и документации не обращаются к реальному API Proxmox.

• Храните учётные данные вне репозиториев, истории оболочки (насколько это возможно) и общих конфигурационных файлов. Используйте API-токен Proxmox с минимальными привилегиями.

• Получайте релизы только из Theorvane/proxmox-mcp GitHub Releases и проверяйте опубликованную SHA-256 контрольную сумму перед запуском архива.

Документация

• Конфигурация

• Безопасность

• API и контракт инструментов

• Установка из GitHub Release

• Участие в разработке

• Безопасность

Проверка и участие в разработке

Участники работают в ветке, основанной на dev и связанной с номером issue, открывают pull request в dev и продвигают только проверенный dev в main. Архивы GitHub Release являются единственным каналом распространения. См. CONTRIBUTING.md.

Мейнтейнеры могут выполнять те же локальные команды проверки, что используются в проекте:

npm ci
npm run lint
npm run typecheck
npm test
npm run build
npm run release:archive
npm run verify:release-archive
npm run validate:docs
npm run validate:governance
npm run validate:release
npm audit --omit=dev --audit-level=high
git diff --check

Лицензия

Этот проект лицензирован на условиях, указанных в LICENSE.