build123d-mcp
MCP-сервер для CAD на build123d: агент строит деталь шагами, смотрит рендер, мерит геометрию и выгружает STEP и STL.
- 149 ★ репозитория
- Последний коммит
- Apache-2.0
Расширенный доступ
Почему такой уровень
- Сервер выполняет сгенерированный ИИ код Python в своем процессе, хотя импорты и встроенные функции ограничены.
- Экспорт записывает файлы моделей на диск.
Установка
- Работает в
Ручная установка
uv tool run --python 3.12 build123d-mcp@latest --versionПроверка, что пакет запускается. Нужен `uv`, клонировать репозиторий не требуется.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Сервер выполняет сгенерированный ИИ код Python в своем процессе, хотя импорты и встроенные функции ограничены.
- Экспорт записывает файлы моделей на диск.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер дает ИИ-ассистенту инструменты для работы с моделями build123d. Агент выполняет код в постоянной CAD-сессии, рендерит превью в PNG, SVG и DXF, измеряет объем, площадь, габариты и центр масс, а затем проверяет модель перед выгрузкой. Среди инструментов поиск отверстий, бобышек и зенковок, проверка пригодности к печати, сравнение форм, импорт STEP и STL, снимки сессии и предпросмотр 2D-чертежей. Экспорт идет в STEP, STL, DXF и SVG, в том числе несколькими форматами сразу. Деталь собирается по одной особенности за раз, и после важных шагов агент смотрит результат.
Для кого. Инженерам и мейкерам, которые проектируют детали для 3D-печати и станков вместе с Claude Code, Cursor или Codex CLI.
Подходит, если
- Нужна монтажная пластина с отверстиями, и агент должен проверить размеры до выгрузки.
- Импортированный STEP правят: размер сквозного отверстия меняют через `edit_feature`.
- Деталь не проходит `validate()`, и агенту нужен режим ремонта.
- Чертеж детали нужен как 2D-превью в SVG или DXF.
Не подходит, если
- Нужен многопользовательский сервис: HTTP-режим не защищен и держит одну общую сессию.
- Модели строят в FreeCAD, OpenSCAD или AutoCAD: сервер работает только с build123d.
- Отверстия с зенковками, цековками и несколькими гранями надо править автоматически: `edit_feature` их отклоняет.
Пример запроса к агенту
Используй build123d-mcp: сделай пластину 60 x 40 x 6 мм с двумя отверстиями 5 мм на расстоянии 40 мм, отрендери, измерь и выгрузи STEP и STL.MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Сервер выполняет сгенерированный ИИ код Python через `exec()`. Защита построена на проверке AST, белом списке импортов (`build123d`, `math`, `numpy` и еще несколько модулей) и урезанных встроенных функциях. Автор называет инструмент локальным и не рассчитанным на многопользовательские или промышленные развертывания. Главная угроза — внедрение инструкций через файл или страницу, которые ассистент разбирает. HTTP-режим (`--transport http`) не имеет встроенной авторизации, поэтому не выставляйте его наружу. Нужен менеджер пакетов `uv`; Python 3.11–3.14 поддерживается, `uv` при необходимости скачает 3.12.
Как отключить. Удалите запись `build123d-mcp` из MCP-конфигурации клиента и перезапустите его. Файлы экспорта и снимки сессий очистите вручную.
Частые вопросы
Как подключить build123d-mcp к Claude Code?
Добавьте сервер в `.mcp.json` проекта или в `~/.claude/mcp.json`: команда `uv`, аргументы `tool run --python 3.12 build123d-mcp@latest`. После правки конфига перезапустите Claude Code.
Нужно ли клонировать репозиторий?
Нет, для обычной работы клон не нужен: клиент сам запускает пакет как локальный процесс по stdio. Клон нужен для разработки и тестов.
Как научить ассистента порядку работы?
Вызовите `install_skill`, например `install_skill(target="agents-md", skill="modeling")`. Поддерживаются цели `claude`, `cursor` и `windsurf`, а скиллы — `modeling`, `drawing` и `repair`.
Можно ли запустить сервер по HTTP?
Да, командой `uv tool run --python 3.12 "build123d-mcp[http]@latest" --transport http --host 127.0.0.1 --port 8000`. Клиент подключается к `http://localhost:8000/mcp`. Авторизации нет, сессия одна на всех.
Можно ли попробовать без установки на свой компьютер?
Да, через GitHub Codespaces: в репозитории есть dev-контейнер с Python 3.12, `uv` и расширениями Copilot. Для LLM-части нужен доступ к GitHub Copilot.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер САПР ClassCAD: агент строит детали и сборки скриптами, смотрит снимки и сохраняет STEP и STL
agentcad дает ИИ-агенту 3D-проектирование: скрипты build123d, экспорт STEP, рендер, проверка геометрии, просмотр в браузере
MCP-сервер для OpenSCAD: агент рендерит детали с известным масштабом, измеряет геометрию и ищет коллизии в сборках
MCP-сервер для CAD-моделирования в SolidCraft: агент строит параметрические 3D-детали, измеряет объем и центр масс, смотрит скриншот и экспортирует в STEP
PartCAD хранит механические детали как текст: агент пишет CAD-скрипт, рендерит модель и сверяет ее с заданием.
FreeCAD MCP — ИИ-агент в параметрическом CAD
FreeCAD MCP (blwfish)
MCP-мост между агентом и FreeCAD: 41 инструмент для параметрических деталей, CAM-траекторий, сеток и диагностики модели
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| build123d-mcp (эта карточка) | нет | не нужна | 149 | |
| OpenSCAD MCP | нет | не нужна | 170 | работает с OpenSCAD; build123d-mcp строит модели на Python-библиотеке build123d и выгружает STEP |
| FreeCAD MCP | нет | не нужна | 3 310 | управляет запущенным FreeCAD; build123d-mcp держит свою CAD-сессию без графического редактора |
Коротко о README
Автор называет проект набором CAD-инструментов, которые ИИ-приложение вызывает через MCP. На публичной таблице CADGenBench в июне 2026 года оценка той же модели с сервером выросла с 0,360 до 0,457, а доля валидных моделей с 88% до 100%.