Live Preview MCP Server

Версия 1.1 (после усиления защиты по итогам red-team) — сервер Model Context Protocol промышленного уровня, который позволяет любому MCP-совместимому ИИ-ассистенту запускать, управлять и встраивать живые превью приложений в iframe.

Усиление безопасности (v1.1)

• Отсутствие внедрения в оболочку: Docker и запуск процессов всегда используют массивы аргументов (shell: false).

• Безопасное окружение: Передаётся только явный allow-list переменных окружения; опасные ключи (NODE_OPTIONS, LD_PRELOAD и т.д.) удаляются.

• Проверка путей с защитой от симлинков: realpathSync перед проверкой allow-list.

• Ограничение частоты WebSocket + лимиты соединений на одно превью.

• Готовность по жизнеспособности процесса: проверка готовности также подтверждает, что дочерний процесс всё ещё жив.

• Лимит одновременных превью (по умолчанию 10).

• Docker: CapDrop: ALL, no-new-privileges, не-root пользователь где возможно, AutoRemove + сборщик осиротевших процессов при запуске.

• Более строгая очистка логов (JWT, AWS-ключи, токены GitHub/Slack/OpenAI и т.д.).

• Длина токена увеличена до 32 случайных байт.

Related MCP server: Runbox Website Builder MCP

Возможности

• MCP-инструменты: start_preview, stop_preview, get_preview_status, get_preview_logs, list_previews, reload_preview, update_preview_config, share_preview, get_mobile_qr, set_auth_token

• Автоматическое определение фреймворка: Vite, Next.js, CRA, Vue, Angular, Express, static, Expo, Flutter

• HTTP-панель управления + обратный прокси с удалёнными заголовками фрейминга

• Опционально: Docker, туннели Cloudflare/ngrok, QR для мобильных устройств, токен-аутентификация, поддержка Cloud-IDE

Требования

• Node.js ≥ 18

• Опционально: Docker, cloudflared, ngrok

Установка и сборка

cd live-preview-mcp
npm install
npm run build

Запуск

node dist/index.js

Конфигурация MCP-клиента

{
  "mcpServers": {
    "live-preview": {
      "command": "node",
      "args": ["/absolute/path/to/live-preview-mcp/dist/index.js"],
      "env": {
        "PORT": "9000",
        "ALLOWED_DIRS": "/path/to/projects"
      }
    }
  }
}

Лицензия

MIT