build123d MCP

build123d MCP — MCP-сервер сообщества (автор — pzfreo). 3D CAD через build123d: выполнение, рендер, измерение и экспорт геометрии. Лицензия Apache-2.0.

Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026

Кратко о сервере

Разработчик
pzfreo
Лицензия
Apache-2.0
Транспорт
stdio
Авторизация
none
ОС
linux, macos, windows
Языки
python

Уровень риска: high

Исполняет код build123d на Python, читает импортируемые модели и записывает экспорт; HTTP-режим без авторизации.

Настройка клиентов

cursor
{
    "code": "{\n  \"mcpServers\": {\n    \"build123d-mcp\": {\n      \"command\": \"uv\",\n      \"args\": [\"tool\", \"run\", \"--python\", \"3.12\", \"build123d-mcp@latest\"]\n    }\n  }\n}",
    "file": "~/.cursor/mcp.json",
    "lang": "json",
    "notes": "Или Settings → MCP",
    "verified": "docs"
}

Что умеет

build123d-mcp — набор инструментов САПР, который ИИ-приложение использует через MCP. Это не отдельный чат-бот и не программа CAD: сервер даёт ассистенту в Claude, Cursor, VS Code, Continue, Cline или Codex CLI возможность создавать модели на Python-библиотеке build123d, рендерить превью, измерять геометрию, исправлять ошибки и экспортировать файлы STEP, STL, SVG и DXF. Вместо того чтобы писать весь CAD-скрипт вслепую, ассистент строит деталь маленькими шагами и проверяет результат по ходу.

По данным README, на публичном рейтинге CADGenBench в июне 2026 года использование build123d-mcp подняло оценку той же модели с 0,360 до 0,457, а долю корректных моделей — с 88% до 100%.

Возможности инструментов:

  • выполнение кода build123d в постоянной CAD-сессии;
  • превью в PNG, SVG и DXF;
  • измерение объёма, площади, габаритов, топологии и центра масс;
  • поиск отверстий, бобышек, зенковок и массивов отверстий;
  • проверка пригодности к 3D-печати, сравнение посадок и выравнивания, проверка корректности экспорта;
  • импорт STEP и STL для сравнения и редактирования (например, изменение диаметра сквозного отверстия с проверкой результата);
  • экспорт в STEP, STL, DXF, SVG или сразу в несколько форматов;
  • сохранение и восстановление снимков сессии;
  • превью 2D-чертежей.

Инструмент install_skill добавляет в файлы инструкций проекта (AGENTS.md, а также для Claude, Cursor и Windsurf) руководства по моделированию, чертежам и ремонту невалидных тел.

Кому подойдёт

  • Инженерам и конструкторам, которые хотят описывать детали словами.
  • Мейкерам и любителям 3D-печати: крепёжные пластины, корпуса, кронштейны.
  • Разработчикам, работающим с параметрическим CAD на Python.

Похожие серверы — в категории 3D и геймдев.

Установка

Нужен только uv; клонировать репозиторий не требуется. Проверьте запуск: uv tool run --python 3.12 build123d-mcp@latest --version. Поддерживаются Python 3.11–3.14, uv сам скачает нужную версию. Для браузерной пробы есть GitHub Codespaces с Copilot Chat, где всё уже установлено. HTTP-режим (--transport http) предназначен только для продвинутых развёртываний.

Подключение к клиентам

Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.

{
  "mcpServers": {
    "build123d-mcp": {
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp@latest"]
    }
  }
}

Для Claude Code конфиг кладётся в .mcp.json проекта или ~/.claude/mcp.json; тот же JSON подходит для Claude Desktop (claude_desktop_config.json) и Cursor (~/.cursor/mcp.json). Для Continue, Cline и Codex CLI используйте ту же команду uv с теми же аргументами. После правки перезапустите приложение.

Проверка

README предлагает тестовый запрос: сделать монтажную пластину 60 × 40 × 6 мм с двумя сквозными отверстиями 5 мм на расстоянии 40 мм, отрендерить, измерить и экспортировать STEP и STL.

Примеры задач

Используй build123d-mcp: построй корпус 80 × 50 × 25 мм со стенкой 2 мм, отрендери после основных элементов, запусти validate() и экспортируй STEP.
Импортируй bracket.step и увеличь сквозные отверстия до 8 мм, не трогая остальные.

Риски

  • Выполнение кода. Сервер исполняет код build123d на Python на вашей машине — подробности о песочнице описаны в документации безопасности проекта.
  • Файлы. Читает импортируемые STEP и STL, записывает экспортированные модели и превью; install_skill дописывает файлы инструкций в проект.
  • HTTP-режим без встроенной авторизации и с одной общей сессией; не открывайте его нескольким пользователям и не отключайте защиту от DNS rebinding без доверенного шлюза.

Частые вопросы

Нужно ли устанавливать CAD-программу?

Нет, достаточно uv: он скачает пакет и нужный Python.

В какие форматы можно экспортировать?

STEP, STL, DXF и SVG, в том числе сразу в несколько.

Можно ли попробовать без установки?

Да, в GitHub Codespaces с Copilot Chat; нужен доступ к GitHub Copilot.

Основы протокола — на странице что такое MCP-сервер.

Похожие MCP-серверы

MCP for Blender

MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники