@velxor/mcp

Сервер MCP (Model Context Protocol), который позволяет Claude Code, Cursor и другим MCP-совместимым агентам управлять всеми тремя столпами Vlexor — AI-видеомонтажом, генерацией игровых ассетов и производством моушн-графики — непосредственно из сеанса кодирования.

Видеомонтаж выполняется на ваших собственных файлах: ваше исходное видео никогда не покидает ваш компьютер — только текст ваших инструкций (и, опционально, расшифровка) отправляется в Vlexor для создания плана монтажа, который компилируется в реальную команду FFmpeg и рендерится полностью локально. Генерация ассетов и моушн-графика рендерятся на стороне сервера (защищать локальные файлы не нужно) и возвращают подписанный URL для скачивания — опционально с сохранением сразу в локальный путь.

Настройка

1. Сгенерируйте личный API-ключ в Vlexor → Настройки → MCP и API.

2. Установите FFmpeg, если он ещё не установлен (brew install ffmpeg на macOS, или укажите VLEXOR_FFMPEG_DIR на папку, содержащую ffmpeg/ffprobe).

3. Добавьте это в конфигурацию вашего MCP-клиента:

{
  "mcpServers": {
    "vlexor": {
      "command": "npx",
      "args": ["-y", "@velxor/mcp"],
      "env": { "VLEXOR_API_KEY": "vlx_…" }
    }
  }
}

Related MCP server: CutPilot

Инструменты

Столп 1 — видеомонтаж (рендерится локально; файлы не загружаются):

• probe_media — считывает длительность, разрешение, FPS, кодек локального видео.

• generate_edit_plan — инструкция на естественном языке → структурированный план монтажа (вызывает реальный Vlexor Command Engine; расходует использование вашего тарифа).

• compile_edit_plan — план монтажа → реальная команда FFmpeg, вычисляемая полностью локально.

• render — выполняет скомпилированную команду локально для создания финального видео.

Типичный поток агента: probe_media → generate_edit_plan → (просмотр шагов) → compile_edit_plan → (просмотр команды FFmpeg) → render.

Столп 2 — генерация ассетов (рендерится на стороне сервера):

• generate_game_asset — запрос → текстура, 2D-персонаж, спрайтовый лист, 3D-модель (.glb), звуковой эффект, музыкальный трек, параллакс-фон или разворот персонажа. Возвращает подписанный URL для скачивания; передайте savePath, чтобы также записать файл локально.

Столп 3 — моушн-графика (рендерится на стороне сервера):

• generate_motion_graphic — краткое креативное задание → отрендеренный .mp4 с кинетическим заголовком (анонс/промо-карточка). Возвращает подписанный URL для скачивания; передайте savePath, чтобы также записать файл локально.

Переменные окружения

Об этом репозитории

Этот пакет — тонкий интеграционный слой, соединяющий MCP-клиент с реальным хостируемым API Vlexor — каждый вызов инструмента здесь представляет собой обычный, проверяемый HTTP-запрос (вы можете точно увидеть, что покидает ваш компьютер, в src/api-client.ts). Он открыт, чтобы разработчики агентов, передающие через него свой API-ключ, могли убедиться в этом самостоятельно.

Сама платформа Vlexor — движок монтажа, дизайн AI-запросов, конвейеры генерации ассетов/моушн-графики — является закрытым исходным кодом. Некоторые импорты этого пакета (компилятор планов FFmpeg из @velxor/engine, определения типов из @velxor/shared) взяты из этой приватной кодовой базы и не публикуются отдельно, поэтому этот репозиторий не будет работать с pnpm install/сборкой в одиночку — он предназначен для чтения и запуска через предварительно собранный npm-пакет (npx -y @velxor/mcp), а не для компиляции из этого клона.

Приветствуются вопросы и PR, касающиеся самого интеграционного слоя MCP (схемы инструментов, обработка ошибок, локальная оркестрация FFmpeg).

Лицензия

MIT