PartMode MCP
Удаленный MCP-сервер браузерного CAD PartMode: агент правит параметрические детали, сборки и чертежи
- 505 ★ репозитория
- Последний коммит
- AGPL-3.0
Расширенный доступ
Почему такой уровень
- Агент вызывает внешний сервис и вносит правки в проект, причем каждая фиксация привязана к ревизии документа
- Команды и ответы идут через сервер PartMode без сквозного шифрования
Установка
- Работает в
Ручная установка
codex mcp add partmode --url https://partmode.com/mcp --bearer-token-env-var PARTMODE_AGENT_KEYКлюч создают на странице Agent access аккаунта PartMode и хранят в переменной окружения, откуда его читает клиент.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент вызывает внешний сервис и вносит правки в проект, причем каждая фиксация привязана к ревизии документа
- Команды и ответы идут через сервер PartMode без сквозного шифрования
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
PartMode — браузерный механический CAD на OpenCascade WebAssembly. Агент подключается к нему по удаленному MCP-серверу и работает с тем же документом, что и человек: эскизы с размерами и выражениями, история операций, сборки с сопряжениями, чертежи. Геометрию считает точное ядро B-rep, поэтому провалившуюся пересборку агент видит как ошибку. В браузерной сессии вы держите проект открытым во вкладке PartMode и один раз подтверждаете подключение агента к проекту. Агент читает состояние через cad_inspect и cad_query, готовит правку в cad_preview и фиксирует ее в cad_commit, только если ревизия документа не изменилась. Отклонить подключение, поставить сессию на паузу или отозвать ключ можно в любой момент. Для работы без открытой вкладки есть headless-режим. Ключ с отдельным разрешением открывает проект на сервере PartMode, а инструмент partmode_headless_export_step выгружает модель в STEP. Всего сервер отдает 15 инструментов, а допустимые операции конкретной сборки возвращает cad_capabilities.
Для кого. Для инженеров-конструкторов и разработчиков, которые поручают агенту параметрическое моделирование деталей и сборок и берут готовые файлы STEP для других CAD-систем.
Подходит, если
- Нужно поменять размер или выражение в параметрической модели и пересобрать геометрию, пока вы смотрите на результат во вкладке
- Нужно собрать узел из деталей с сопряжениями и проверить массу, центр масс и тензор инерции по материалам
- Надо выгрузить точную модель в STEP по расписанию или из скрипта, без открытого браузера
- Хотите видеть каждую правку агента в предпросмотре до того, как она попадет в проект
Не подходит, если
- Нужен офлайн-режим: очереди команд нет, а релей держит их только в памяти процесса
- Нужны инженерные расчеты, CAM или родной формат DWG: PartMode их пока не поддерживает
- Нужен полноценный DXF: экспорт DXF ограничен подмножеством формата R12
- Вы работаете в SolidWorks, FreeCAD или AutoCAD: PartMode управляет только собственными проектами
Пример запроса к агенту
Подключись к моему проекту в PartMode, увеличь толщину кронштейна до 6 мм, покажи предпросмотр и зафиксируй правку после моего подтвержденияMCP
- Транспорт
- http
- Авторизация
- API-ключ
Переменные окружения
PARTMODE_AGENT_KEYобязательная, секрет- Отзываемый ключ агента из аккаунта PartMode, клиент отправляет его как bearer-токен
Ограничения
- Нужен аккаунт PartMode и отзываемый ключ агента. Сам по себе ключ прав на CAD не дает: права зависят от подтвержденной сессии в браузере или от headless-разрешения, которое задают при создании ключа и потом не добавляют.
- Релей между агентом и вкладкой не использует сквозное шифрование. Проект остается в браузере, а команды и ответы идут по HTTPS через сервер.
- Активная headless-сессия длится не дольше часа и не переживает перезапуск сервиса. Закоммиченные документы хранятся на сервере до удаления аккаунта. Отдельной кнопки удаления проекта пока нет, а лимит равен 32 проектам.
- Инструменты cad_artifact, cad_ui и cad_events работают только в браузерной сессии, а в headless-режиме артефактом служит только STEP.
Как отключить. Отзовите ключ на странице Agent access в аккаунте PartMode: проверка ключа прекратится сразу, живые headless-сессии закроются. Затем уберите запись partmode из настроек MCP вашего агента.
Частые вопросы
Как подключить PartMode к Codex?
Создайте ключ на странице Agent access в аккаунте PartMode, сохраните его в переменной PARTMODE_AGENT_KEY и выполните `codex mcp add partmode --url https://partmode.com/mcp --bearer-token-env-var PARTMODE_AGENT_KEY`. Сервер появится у агента после перезапуска сессии.
Чем браузерная сессия PartMode отличается от headless?
В браузерной сессии проект остается в вашем браузере, а подключение агента вы подтверждаете во вкладке. В headless-режиме агент работает с копией проекта на сервере PartMode без открытой вкладки и без подтверждения.
Как выгрузить модель из PartMode в STEP через агента?
Откройте headless-сессию инструментом partmode_headless_open с постоянным projectId, внесите правки и вызовите partmode_headless_export_step. Ключ для этого создают сразу с headless-разрешением.
Можно ли запустить PartMode у себя?
Да, лицензия AGPL v3 это разрешает. Нужен Node.js 22.13 или новее: клонируйте репозиторий, выполните `npm ci`, `npm run build` и `npm start`, затем откройте http://127.0.0.1:4401. Локальный CAD в браузере работает без аккаунта.
Что PartMode хранит на сервере при работе агента?
В браузерной сессии сервер проект не сохраняет. В headless-режиме сервер хранит идентификатор и название проекта, ревизию, полный JSON документа, его хеш и отметки времени.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для CAD-моделирования в SolidCraft: агент строит параметрические 3D-детали, измеряет объем и центр масс, смотрит скриншот и экспортирует в STEP
MCP-сервер дает агенту править открытый проект в Altium Designer, KiCad или EasyEDA Pro: схемы, платы, библиотеки, проверки
MCP-сервер для проектирования печатных плат в KiCAD: агент размещает компоненты, разводит связи, проверяет DRC и готовит файлы на производство
MCP-сервер, который превращает машину с RAD Studio в удаленный бэкенд для агентов: чтение, безопасная правка, сборка MSBuild, git и деплой
MCP-сервер для разработки по спецификациям: требования, дизайн и задачи по шагам, с веб-дашбордом и расширением для VS Code
MCP сервер для проектирования плат в KiCAD 10: схема, разводка, проверки и подготовка к производству через агента
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| PartMode (эта запись) | да | API-ключ | 505 | |
| FreeCAD MCP | нет | не нужна | 3 108 | управляет настольным FreeCAD на вашей машине, PartMode работает в браузере с подтверждением правок |
| SolidWorks MCP на TypeScript | нет | не нужна | 245 | управляет установленным SolidWorks на Windows, у PartMode CAD живет в браузере |
| CAD-MCP Server | нет | не нужна | 650 | чертит в AutoCAD, GstarCAD и ZWCAD, а PartMode моделирует параметрические тела и сборки |
Коротко о README
Страница репозитория разбирает возможности по областям: детали, сборки, чертежи, форматы обмена и инспекция геометрии. Дальше идут схема двух путей полномочий агента, запуск у себя через npm и карта архитектуры. В конце правила для контрибьюторов и список smoke-проверок после правок.