brepjs — CAD на TypeScript и проверка деталей агентом
brepjs
Точная B-Rep-геометрия на TypeScript с проверкой brep verify, MCP-сервером и плагином Claude Code: агент пишет и проверяет деталь
- 142 ★ репозитория
- Последний коммит
- Apache-2.0
Минимальный доступ
Почему такой уровень
- Плагин и пакеты пишут TypeScript-файлы деталей и запускают проверку, а к сети и системным ресурсам вне проекта не обращаются
- Размеры и допуски детали агент может вывести неверно, перед производством их проверяют по чертежу
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add plugins/brepjsОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемМинимальный доступИнструмент ничего не запускает и не ходит в сеть.
- Плагин и пакеты пишут TypeScript-файлы деталей и запускают проверку, а к сети и системным ресурсам вне проекта не обращаются
- Размеры и допуски детали агент может вывести неверно, перед производством их проверяют по чертежу
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
brepjs — библиотека точной твердотельной геометрии (B-Rep) на TypeScript поверх OpenCascade, собранная так, чтобы агент писал деталь обычным TypeScript-файлом и сам проверял ее. Фигуры задаются точными границами, без сетки треугольников, поэтому булевы операции точны, измерения настоящие, а экспорт идет в STEP. Проверка идет командой `npx brep verify part.brep.ts`: ошибка возвращается агенту, и тот исправляет деталь. В показанном сеансе Claude Code читает официальный чертеж Raspberry Pi 5, пишет корпус как деталь brepjs, получает ошибку, исправляет ее и по просьбе добавляет крепление вентилятора. Результат STEP открывается во FreeCAD. Перечисленные способы подключения: пакеты `brepjs`, `brepjs-cad` и `occt-wasm` из npm, MCP-сервер `brep-mcp` и плагин Claude Code `brepjs@brepjs` с навыками написания деталей. Агент по описанию пересобрал все 46 деталей галереи примеров, и все 46 прошли проверку. Типы и `Result<T,E>` доказывают корректность геометрии при компиляции.
Для кого. Конструкторам, мейкерам и разработчикам, которые проектируют корпуса, кронштейны и оснастку кодом и поручают агенту рисовать детали.
Подходит, если
- Корпус для платы по официальному чертежу надо описать кодом и экспортировать в STEP
- Деталь с отверстиями, скруглениями и фасками следует собрать параметрически
- Агент должен получать ошибку проверки и сам исправлять геометрию
- Нужен проверяемый результат: настоящие объемы, площади и зазоры
- Хочется подключить CAD-проверку к любому MCP-клиенту
Не подходит, если
- Нужна органическая скульптура или плотные решетки: библиотека для точных деталей, для такой геометрии нужны полевые методы
- Нужна работа без Node.js: пакеты рассчитаны на TypeScript и ESM
- Требуется визуальный редактор: деталь описывается кодом
- Сеточная модель для игры нужна: STEP и B-Rep для этого не предназначены
Пример запроса к агенту
Нарисуй корпус для Raspberry Pi 5 как деталь brepjs, проверь ее командой brep verify, исправь ошибки и экспортируй в STEP.Ограничения
Библиотека сильна в точной производимой геометрии: булевы операции, скругления, фаски, оболочки, STEP. Для органических форм и плотных решеток она не подходит. Модуль `brepjs/quick` работает как ESM и инициализирует WASM через top-level await.
Геометрическое ядро занимает заметный объем и грузится как WebAssembly. Проверка `brep verify` подтверждает корректность тела и не знает вашего замысла, поэтому размеры деталей стоит сверять с чертежом. Результат измерения агента на галерее из 46 деталей описан автором и не заменяет вашей проверки.
Как отключить. Удалите плагин командой `/plugin uninstall brepjs` в Claude Code, а пакеты командой `npm uninstall brepjs brepjs-cad occt-wasm` из проекта.
Частые вопросы
Как поставить brepjs в Claude Code?
Выполните `/plugin marketplace add andymai/brepjs`, затем `/plugin install brepjs@brepjs`. Пакеты для проекта ставит `npm i -D brepjs brepjs-cad occt-wasm`.
Что проверяет brep verify?
Команда `npx brep verify part.brep.ts` собирает деталь и возвращает ошибку, если геометрия некорректна. Агент читает ошибку, правит файл и повторяет проверку, пока она не пройдет.
Работает ли brepjs без Claude Code?
Да. Детали пишутся обычными TypeScript-файлами, а проверка работает как CLI, поэтому подойдет любой агент. Клиенты MCP используют сервер `brep-mcp`.
В какой формат экспортируются детали?
В STEP, который открывают FreeCAD и другие CAD-программы. Твердые тела получаются герметичными и без потерь проходят цикл STEP.
Что можно проектировать?
Корпуса, кронштейны, оснастку, бины Gridfinity, обработанные и литые детали: от одной детали до сборки. Для органического скульптинга и плотных решеток библиотека не рассчитана.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
ПлагиныУдаленный MCP-сервер браузерного CAD PartMode: агент правит параметрические детали, сборки и чертежи
MCP-серверы Bitbybit: точные подписи 2205 функций CAD для агента и облачный запуск геометрии в CAD Cloud
PartCAD хранит механические детали как текст: агент пишет CAD-скрипт, рендерит модель и сверяет ее с заданием.
MCP-сервер САПР ClassCAD: агент строит детали и сборки скриптами, смотрит снимки и сохраняет STEP и STL
agentcad дает ИИ-агенту 3D-проектирование: скрипты build123d, экспорт STEP, рендер, проверка геометрии, просмотр в браузере
MCP-сервер для OpenSCAD: агент рендерит детали с известным масштабом, измеряет геометрию и ищет коллизии в сборках
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| brepjs — CAD на TypeScript и проверка деталей агентом (эта карточка) | нет | 142 | ||
| text-to-cad | нет | 26 233 | превращает текст в CAD без типобезопасной библиотеки и проверки | |
| FreeCAD MCP | нет | не нужна | 3 310 | управляет программой FreeCAD по MCP, у brepjs нет внешней программы |
Коротко о README
README показывает сеанс агента с корпусом Raspberry Pi 5, объясняет, зачем библиотека написана и как она строит типобезопасную геометрию. Затем идут установка пакетов, инициализация ядра, быстрый старт и пример детали с отверстием и скруглениями. Живая площадка и справочник доступны на сайте проекта.