OpenSCAD MCP
MCP-сервер для OpenSCAD: агент рендерит детали с известным масштабом, измеряет геометрию и ищет коллизии в сборках
- 170 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Запускает локальный OpenSCAD на присланном коде и без списка разрешенных путей читает любые файлы процесса
- Записывает файлы экспорта и кэш рендеров на диск
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/openscad-mcpОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Запускает локальный OpenSCAD на присланном коде и без списка разрешенных путей читает любые файлы процесса
- Записывает файлы экспорта и кэш рендеров на диск
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
MCP-сервер запускает локальный OpenSCAD и возвращает агенту изображения вместе с текстовой сводкой: камера, направление взгляда, масштаб, габариты. Инструмент `render` строит виды, точные сечения со шкалой, детали разными цветами и сравнение до и после правки. Инструмент measure выдает числа по самой геометрии: габариты, объем, площадь, массу и центр масс, отверстия с диаметром и глубиной, нависания, острова и толщину стенок для FDM-печати. Инструмент check сверяет детали сборки между собой: пересечения с глубиной проникновения, минимальный зазор, площадь контакта, соосность отверстий и движение. Правила проверок хранятся в YAML-файле и запускаются из оболочки командой `openscad-mcp check checks.yaml` с кодом выхода 0, 1 или 2. export_model сохраняет STL, 3MF, AMF, DXF, SVG, PDF и CSG, а сборку упаковывает в один 3MF с именованными объектами. Справочник `reference` хранит посадки, метрический крепеж, резьбовые вставки, подшипники, магниты и правила FDM. Каждый ответ содержит `errors`, `warnings` и `hints` из вывода OpenSCAD, потому что при провалившемся `assert`() программа все равно завершается с кодом 0 и рисует пустую сцену.
Для кого. Инженерам и мейкерам, которые проектируют печатные детали и сборки в OpenSCAD вместе с агентом и хотят проверять размеры числами, а не на глаз.
Подходит, если
- Корпус с крышкой собран из нескольких деталей, и надо найти пересечения и зазоры до печати
- Агент нарисовал деталь, и по снимку с масштабом нужно сверить ее габариты и толщину стенок
- Под винты M3 и подшипник 608 требуется подобрать посадки и диаметры отверстий
- Проверки сборки должны запускаться в Makefile или CI с понятным кодом выхода
- Готовую сборку надо выгрузить в 3MF с именованными деталями для слайсера
Не подходит, если
- Модель делается в FreeCAD или Fusion 360: сервер понимает только исходники OpenSCAD
- Скрипты приходят из недоверенных источников и нет контейнера или ограничения путей
- Нужна свободная скульптурная форма, а не параметрическая деталь из кода
Пример запроса к агенту
Сделай сечение крышки на высоте 12 мм по оси z и скажи толщину стенки, потом проверь зазор между крышкой и корпусомMCP
- Транспорт
- stdio, http, sse
- Авторизация
- не нужна
Переменные окружения
OPENSCAD_PATH- Путь к исполняемому файлу OpenSCAD, если он не найден автоматически.
MCP_ALLOWED_PATHS- Каталоги, из которых скриптам разрешено читать файлы. Без значения проверка путей отключена.
Ограничения
Установленный OpenSCAD обязателен, минимум версии 2021.01. Сервер запускается через uv или Python 3.10 и новее. По умолчанию список разрешенных путей MCP_ALLOWED_PATHS не задан: OpenSCAD может читать любой файл, доступный процессу, через `include`, `use` и `import`, а песочницы на уровне ОС нет. Для чужих скриптов сервер лучше держать в контейнере. Каждое изображение стоит около 640 токенов зрения, поэтому просить стоит только нужные виды. Расстояния меньше погрешности тесселяции check помечает как неразрешенные и просит повысить качество.
Как отключить. Удалите сервер командой `claude mcp remove openscad` или уберите запись openscad из конфигурации MCP клиента. Плагин для Claude Code отключается через /plugin.
Частые вопросы
Как подключить OpenSCAD MCP к Claude Code?
Выполните `claude mcp add openscad --transport stdio -- uvx openscad-mcp`. OpenSCAD должен стоять в системе, иначе укажите путь через `--env OPENSCAD_PATH=/путь/к/openscad`. Инструмент check_openscad покажет версию и возможности.
Чем сервер отличается от запуска openscad в терминале?
Агент получает числа вместе с картинкой: масштаб, габариты, объем, зазоры, глубину пересечений. Ошибки и предупреждения OpenSCAD приходят в ответе, а не теряются при коде выхода 0.
Можно ли запускать проверки сборки в CI?
Да. Команда `uvx openscad-mcp check checks.yaml --allow /путь/к/проекту` читает файл правил и завершается с кодом 0, 1 или 2, так что ее легко вызвать из Makefile.
С какими агентами работает?
Claude Code ставит сервер одной командой или как плагин со скиллом openscad-design. Для Claude Desktop, Cursor, Windsurf и VS Code в README есть готовые фрагменты конфигурации.
Что делать, если OpenSCAD завершается без ошибки, а сцена пустая?
Прочитайте поля `errors`, `warnings` и `hints` в ответе сервера: OpenSCAD выходит с кодом 0 даже при провалившемся `assert`(), и сервер выносит такие сообщения в ответ.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для CAD на build123d: агент строит деталь шагами, смотрит рендер, мерит геометрию и выгружает STEP и STL.
MCP-сервер для CAD-моделирования в SolidCraft: агент строит параметрические 3D-детали, измеряет объем и центр масс, смотрит скриншот и экспортирует в STEP
FreeCAD MCP — ИИ-агент в параметрическом CAD
FreeCAD MCP (blwfish)
MCP-мост между агентом и FreeCAD: 41 инструмент для параметрических деталей, CAM-траекторий, сеток и диагностики модели
Скилл create-cad-files строит деталь с размерами по описанию словами и выдает проверенные файлы STEP и STL.
MCP-сервер САПР ClassCAD: агент строит детали и сборки скриптами, смотрит снимки и сохраняет STEP и STL
CLI openmcp и расширение VS Code для отладки MCP-серверов: проверка инструментов, промптов и ресурсов, чат с моделью, тесты
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| OpenSCAD MCP (эта карточка) | нет | не нужна | 170 | |
| FreeCAD MCP | нет | не нужна | 3 310 | управляет приложением FreeCAD через аддон, а этот сервер рендерит и проверяет исходники OpenSCAD |
| text-to-cad | нет | 26 233 | библиотека скиллов для CAD, CAE и CAM с экспортом STEP, STL и 3MF, а не сервер рендера и проверок исходников OpenSCAD |
Коротко о README
Сервер на FastMCP для проектирования печатных деталей в OpenSCAD: рендер с масштабом, измерения, проверки сборки, экспорт и справочник по крепежу. Устанавливается через uvx из PyPI, есть плагин для Claude Code со скиллом. Описаны параметры `parts`, quality, `variables` и include_paths, настройки окружения и модель угроз. Лицензия MIT.