Supex MCP

MCP-сервер и расширение для SketchUp: агент пишет и запускает Ruby-скрипты в модели, смотрит сцену и экспортирует результат.

  • 60 ★ репозитория
  • Последний коммит
  • MIT
MCP-сервер

Широкий доступ

Почему такой уровень

  • Агент выполняет произвольный код на Ruby внутри SketchUp с доступом к файлам модели и системе.
  • Проект экспериментальный и работает на macOS с последней версией SketchUp.
Все причины и проверки

darwin/supex

Установка

Ручная установка

git clone --recurse-submodules https://github.com/darwin/supex.git

Шаг 1 README; затем `./scripts/launch-sketchup.sh` и регистрация сервера через `claude mcp add`. Для VCAD нужна сборка `./scripts/rebuild.sh`.

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

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

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Агент выполняет произвольный код на Ruby внутри SketchUp с доступом к файлам модели и системе.
  • Проект экспериментальный и работает на macOS с последней версией SketchUp.

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

Что делает

Supex связывает Claude Code со SketchUp. Агент выполняет любой код на Ruby API SketchUp, встроенный в запрос или взятый из скриптов проекта, а MCP-сервер возвращает осмотр модели: сущности, скриншоты, материалы, камеру и статистику. Скрипты лежат в git, поэтому у работы есть история и подсветка в редакторе. Экспорт поддерживает SKP, OBJ, STL, PNG и JPG. Отдельная часть, VCAD, добавляет параметрическое моделирование на ядре BRep. Агент пишет геометрию на языке Loon, сайдкар на Rust вычисляет из нее тела, а SketchUp импортирует сетку как родной компонент. Доступны булевы операции, скругление, фаска, оболочка, выдавливание, вращение, перенос по пути и массивы.

Для кого. Программистам и моделистам, которые хотят описывать в SketchUp лестницу из 15 ступеней, параметрические узлы и повторяющуюся геометрию словами.

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

  • Нужна лестница или другая параметрическая конструкция, которую неудобно рисовать вручную.
  • Модель надо обследовать: сущности, материалы, камера и статистика одним запросом.
  • Работа по ремонту дома ведется в git, и нужна история скриптов моделирования.
  • Нужно получить твердое тело через ядро BRep и импортировать его в SketchUp компонентом.

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

  • Нужен быстрый эскиз идеи: ручной интерфейс SketchUp для этого удобнее.
  • Вы работаете не на macOS: платформа проверена только на ней.
  • Нужна поддержка старых версий SketchUp: проверена последняя, совместимость не обещана.

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

Создай в SketchUp лестницу из 15 ступеней по параметрам из скрипта, покажи скриншот и экспортируй модель в SKP.

MCP

Транспорт
stdio
Авторизация
не нужна

Ограничения

Проект ранний и экспериментальный: проверен только на macOS, с Claude Code и последней версией SketchUp 2026, а обратной совместимости автор не обещает. Нужны Python 3.14 и новее через uv, Ruby 3.2.2, который привязан к SketchUp и давно вышел из поддержки. Для VCAD дополнительно нужны Rust и Node.js, а сборка сайдкара занимает время. Репозиторий клонируют с подмодулями, иначе вендорные зависимости VCAD не загрузятся. Стабильные релизы лежат в `main`, активная разработка идет в ветке `dev`.

Как отключить. Удалите запись `supex` из `.mcp.json` проекта и символическую ссылку `supex-guide`. Расширение уберите из папки расширений SketchUp, а клонированный репозиторий удалите.

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

Как подключить Supex к Claude Code?

В проекте выполните `claude mcp add --scope project --transport stdio supex -- /path/to/supex/mcp`. Затем свяжите руководство командой `ln -s /path/to/supex/docs/agents/guide supex-guide` и сошлитесь на `supex-guide/README.md` из `CLAUDE.md`.

Как запустить SketchUp с расширением?

Командой `./scripts/launch-sketchup.sh path/to/model.skp`. Скрипт запускает SketchUp, разворачивает исходники расширения без сборки `.rbz` и включает живую перезагрузку.

Что такое VCAD?

Ядро параметрического CAD на BRep: геометрия пишется на языке Loon, сайдкар на Rust строит тела, а SketchUp импортирует результат как компонент. Часть нужна не всем и собирается отдельно.

Как проверить связь с SketchUp?

Выполните `./supex status`: команда покажет состояние соединения и версию SketchUp.

Где посмотреть пример?

Примеры лежат в отдельных ветках. Пример со столом получают командой `git clone -b example-simple-table https://github.com/darwin/supex.git simple-table`.

Обсуждение

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

MCP-серверы

MCP-сервер и скилл для SketchUp: агент строит редактируемую 3D-модель по фото, CAD или описанию и сверяет геометрию с исходником.

MCP-серверРасширенный доступ109Звезды репозитория

MCP-сервер для Autodesk 3ds Max: агент читает сцену, моделирует, настраивает материалы и модификаторы

MCP-серверШирокий доступ386Звезды репозитория

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

MCP-серверРасширенный доступ100Звезды репозитория

Blender Agent Studio строит модели и сцены в Blender по описанию: файл .blend, исходный Python и проверенные рендеры.

ПлагинРасширенный доступ113Звезды репозитория

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

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

Blender MCP

MCP for Blender

Выбор редакции

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

MCP-серверШирокий доступ34,1 тыс.Звезды репозитория

Коротко о README

Автор перенес в SketchUp привычный цикл разработки с агентом: описать намерение, быстро проверить и хранить историю в git. Ручной интерфейс остается для эскизов, а агент берет на себя повторяемую и параметрическую работу.

Бейдж для README

Сообщить о проблеме