Vectreal — MCP-сервер для 3D-сцен в вебе

Vectreal

MCP-сервер из CLI Vectreal: агент загружает GLB, настраивает свет и камеры сцены, публикует ее и выдает код встраивания

27 ★ репозитория
Последний коммит 11 нояб. 2026

vectreal/vectreal-platformАвтор:Vectreal

Установка

Работает в: Claude Code
Cursor
VS Code
SourceCraft
Koda
Coddy

В терминале, через SkillFoxx CLI

npx skillfoxx add mcp/vectreal

Определит агенты на машине, покажет уровень доступа и зафиксирует версию.

Другие способы установки

Доступ и проверки

Как мы проверяем

Расширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.

Агент публикует сцены на общедоступных адресах и создает ключи встраивания с разрешенными доменами
Сессия организации хранится в связке ключей системы и действует с вашими правами

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

Vectreal — открытая платформа для подготовки, хранения и публикации 3D-контента в вебе. Репозиторий содержит приложение, React-пакеты для просмотра и встраивания, SDK для API агентов и CLI @vctrl/cli. У CLI есть команда vectreal mcp, которая отдает агенту инструменты по stdio. Инструменты читают документацию (search_docs, read_doc, вход не нужен), показывают проекты и сцены вашей организации, создают проект и черновик сцены из локального файла GLB. describe_model сообщает размеры, меши, материалы и анимации модели без рендера. get_scene_settings и update_scene_settings читают и меняют освещение, окружение, управление, границы, тени, подачу, камеры и точки интереса. publish_scene сжимает GLB, как это делает издатель (Draco, KTX2), и публикует сцену, unpublish_scene снимает ее. get_embed_snippet выдает код встраивания и ссылку на предпросмотр, при просьбе создает ключ и разрешает домены. Перед работой выполняется vectreal login, сессия хранится в связке ключей системы. Сервер также зарегистрирован в реестре MCP как io.github.Vectreal/vectreal.

Для кого. Веб-разработчикам и дизайнерам, которые встраивают 3D-модели на сайты и хотят поручить публикацию сцен агенту в Claude Code, Cursor или VS Code.

Подходит, если

Есть модель в GLB, и ее надо превратить в сцену на платформе одним запросом агенту
Перед загрузкой хочется увидеть размер, число мешей и материалов модели, не открывая просмотрщик
Свет, окружение и камеры сцены настраиваются под страницу, и агент должен менять их по описанию
Опубликованную сцену нужно встроить на сайт: нужны код встраивания и разрешенные домены
В документации Vectreal надо найти нужный раздел, не выходя из редактора

Не подходит, если

Нужно редактировать геометрию и текстуры: сервер настраивает показ сцены и публикует модель, моделирование остается в Blender и подобных редакторах
Формат модели не GLB: загрузка и публикация рассчитаны на локальные файлы GLB
Нужна работа без аккаунта Vectreal: все инструменты, кроме чтения документации, требуют vectreal login

Пример запроса к агенту

Загрузи model.glb как черновик сцены, настрой мягкий свет и две камеры, опубликуй и дай код встраивания для моего домена

MCP

Транспорт: stdio
Авторизация: OAuth

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

VECTREAL_ORIGIN: Адрес платформы, по умолчанию https://vectreal.com; http допускается только на localhost.

Ограничения

Сервер входит в пакет @vctrl/cli и использует сохраненную сессию, поэтому перед первым вызовом нужен vectreal login. Сессия лежит в связке ключей системы, а на Linux без Secret Service попадает в файл credentials.json в домашней папке и CLI говорит об этом в stderr.

Работа идет от имени организации, которую вы выбрали при входе, с теми правами и областями, которые показывает vectreal whoami. Проект к текущей папке привязывает vectreal init. Сервер ищет эту привязку в CLAUDE_PROJECT_DIR или в папке запуска. Адрес по умолчанию https://vectreal.com, другой задают флагом --origin или переменной VECTREAL_ORIGIN.

Как отключить. Удалите запись vectreal из .mcp.json или командой claude mcp remove vectreal и закройте сессию командой vectreal logout, она завершает вход на сервере и стирает локальные данные.

Частые вопросы

Как подключить MCP-сервер Vectreal к Claude Code?

После npx -y @vctrl/cli login выполните claude mcp add vectreal -- npx -y @vctrl/cli mcp. Или запишите запись в .mcp.json командой npx -y @vctrl/cli mcp install.

Какие агенты поддерживаются?

В документации CLI Vectreal названы Claude Code, Cursor и VS Code. Сервер работает по стандартному stdio, поэтому подойдет клиентам с такой поддержкой.

Что делает publish_scene?

Сжимает локальный GLB так же, как издатель на платформе, использует Draco и KTX2, и публикует сцену. Снять ее с публикации можно через unpublish_scene.

Как встроить сцену на сайт?

get_embed_snippet возвращает код и ссылку на предпросмотр. Если попросить, инструмент создаст ключ встраивания и добавит разрешенные домены.

Где хранится сессия?

В связке ключей системы, по одной записи на адрес сервера. Если связка недоступна, файл credentials.json в ~/.config/vectreal с ограниченным доступом.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы

three.ws 3D Studio MCP

Удаленный MCP-сервер с 40 инструментами: 3D-модель по тексту или фото, риггинг, анимация, ретекстурирование и проверка GLB

MCP-серверШирокий доступ276

openreality-mcp

Официальный

MCP-сервер превращает видео с телефона в 3D-сцену, где агент измеряет, строит маршруты и выгружает данные для роботов

MCP-серверШирокий доступ656

Blender MCP (VxAI)

Blender MCP: агент в Cursor, Cline, Windsurf или Claude Desktop строит и правит 3D-сцены в Blender по описанию, сервер ставится командой uvx

MCP-серверРасширенный доступ301

viz3d

Плагин строит 3D-фильм, приложение, урок, книгу или игру по любой теме, а агент сам проверяет кадры перед показом.

ПлагинРасширенный доступ174

Kiln

Локальный MCP-сервер и CLI: агент пишет JavaScript для 3D-модели, получает рендеры и проверки, а на выходе GLB и исходник

MCP-серверРасширенный доступ327

VidMoat MCP

Vidmoat MCP