Onshape MCP
Onshape MCP строит CAD-модели по запросу в чате: эскизы, выдавливание, сборки с сопряжениями и экспорт в STEP или STL.
- 163 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Агент создает, меняет и удаляет объекты в документах Onshape от имени владельца ключей API.
Установка
- Работает в
Ручная установка
git clone https://github.com/hedless/onshape-mcp.gitПервый шаг установки из README. Дальше: виртуальное окружение и `pip install -e .`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент создает, меняет и удаляет объекты в документах Onshape от имени владельца ключей API.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Onshape MCP, сервер на Python, управляет Onshape через REST API. Агент находит документы, чертит эскизы на плоскостях Front, Top и Right, выдавливает и вращает их, делает фаски и скругления, строит линейные и круговые массивы. README насчитывает 45 инструментов. Для сборок есть вставка деталей, позиционирование, сопряжения четырех видов (жесткое, ползунок, вращательное, цилиндрическое) и поиск пересечений по габаритам. Размеры можно связать с таблицей переменных документа. Готовую модель сервер выгружает в STL, STEP, PARASOLID, GLTF или OBJ.
Для кого. Инженерам и конструкторам, чьи модели живут в Onshape и кому проще описать деталь словами, чем расставлять размеры вручную.
Подходит, если
- Корпус или кронштейн надо собрать по размерам из переписки с заказчиком.
- Две детали в сборке пересекаются, и агенту поручают найти конфликт.
- Параметры детали вынесены в таблицу переменных и меняются из чата.
- Готовую модель выгружают в STEP для передачи подрядчику.
Не подходит, если
- Размеры заданы в миллиметрах, а пересчет в дюймы никто не делает: инструменты эскизов принимают дюймы.
- Модель живет в другой CAD-системе, например в SolidWorks или FreeCAD.
- Владелец аккаунта Onshape не выдает ключи API.
Пример запроса к агенту
Покажи мои документы Onshape, создай Part Studio и нарисуй на плоскости Top прямоугольник 4 на 2 дюйма, затем выдави его на 0,5 дюйма.MCP
- Транспорт
- stdio
- Авторизация
- API-ключ
Переменные окружения
ONSHAPE_ACCESS_KEYобязательная, секрет- Access Key из портала разработчиков Onshape
ONSHAPE_SECRET_KEYобязательная, секрет- Secret Key из портала разработчиков Onshape
Ограничения
Нужен аккаунт Onshape с доступом к API и пара ключей: Access Key и Secret Key. Инструменты эскизов принимают дюймы и градусы, поэтому метрические размеры агент пересчитывает сам. Пересечения ищутся по габаритным контейнерам; у деталей сложной формы возможны ложные срабатывания. По README сервер ставят из клонированного репозитория и указывают в конфиге абсолютный путь к Python виртуального окружения. Агент создает, меняет и удаляет объекты в документах Onshape, поэтому для первых запусков заведите отдельный тестовый документ.
Как отключить. Удалите блок onshape из `mcp.json` и перезапустите Claude Code. Ключи API отзовите на портале разработчиков Onshape.
Частые вопросы
Где взять ключи?
На портале разработчиков Onshape создайте ключ API и скопируйте Access Key и Secret Key. Их передают в переменных `ONSHAPE_ACCESS_KEY` и `ONSHAPE_SECRET_KEY` или в файле `.env`.
Как проверить подключение?
Перезапустите Claude Code после правки `mcp.json` и попросите показать документы Onshape. Пришедший список означает, что сервер работает.
В каких единицах задавать размеры?
Инструменты эскизов принимают дюймы, углы идут в градусах. Метрические размеры пересчитывайте до вызова инструмента.
Какие форматы экспорта есть?
STL, STEP, PARASOLID, GLTF и OBJ, для Part Studio и для сборок.
Безопасно ли выдавать агенту ключи?
Ключи дают доступ к вашим документам Onshape, а агент вправе менять и удалять объекты. Для проб заведите отдельный документ и отзывайте ключ, когда он не нужен.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер подключает агента к FreeCAD для построения деталей, редактирования документов, запуска макросов и экспорта моделей.
MCP-сервер для управления FreeCAD из Claude Desktop и других клиентов: создание и правка моделей, запуск скриптов и FEM-анализ
MCP-сервер для SolidWorks: агент моделирует детали и сборки, оформляет чертежи и восстанавливает деталь по файлу DXF или DWG
MCP-сервер для AutoCAD, GstarCAD и ZWCAD: черчение, правка и запрос чертежа обычными словами
SketchUp MCP
sketchup-mcp2
MCP-сервер для SketchUp: агент создает и меняет геометрию, назначает материалы и экспортирует сцену, а eval_ruby выполняет Ruby внутри программы
MCP-сервер от McNeel: Claude, Codex и Gemini CLI строят и правят геометрию в открытом Rhino 3D и собирают определения Grasshopper
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| Onshape MCP (эта карточка) | нет | API-ключ | 163 | |
| FreeCAD MCP | нет | не нужна | 3 234 | управляет настольным FreeCAD; Onshape MCP работает с облачным Onshape через REST API и ключи доступа |
| Fusion 360 MCP | нет | не нужна | 144 | связывает агента с Fusion 360; Onshape MCP добавляет сопряжения сборок и таблицы переменных Onshape |
Коротко о README
Сервер ставят из клона в виртуальное окружение. Запуск: команда `onshape-mcp` или `python -m onshape_mcp.server`; в Claude Code его подключают блоком в `mcp.json`.