Supex MCP
MCP-сервер и расширение для SketchUp: агент пишет и запускает Ruby-скрипты в модели, смотрит сцену и экспортирует результат.
- 60 ★ репозитория
- Последний коммит
- MIT
Широкий доступ
Почему такой уровень
- Агент выполняет произвольный код на Ruby внутри SketchUp с доступом к файлам модели и системе.
- Проект экспериментальный и работает на macOS с последней версией SketchUp.
Установка
- Работает в
Ручная установка
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-сервер для Autodesk 3ds Max: агент читает сцену, моделирует, настраивает материалы и модификаторы
MCP-сервер для Excalidraw: агент рисует диаграмму, добавляет анимацию по ключевым кадрам, а вы смотрите сборку вживую в браузере
Blender Agent Studio строит модели и сцены в Blender по описанию: файл .blend, исходный Python и проверенные рендеры.
Blender MCP: агент в Cursor, Cline, Windsurf или Claude Desktop строит и правит 3D-сцены в Blender по описанию, сервер ставится командой uvx
Blender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Коротко о README
Автор перенес в SketchUp привычный цикл разработки с агентом: описать намерение, быстро проверить и хранить историю в git. Ручной интерфейс остается для эскизов, а агент берет на себя повторяемую и параметрическую работу.