build123d-mcp

Сервер MCP (Model Context Protocol), который предоставляет инструменты для работы с CAD-операциями build123d, позволяя ИИ-ассистентам интерактивно создавать, проверять и дорабатывать 3D-геометрию.

Зачем это нужно

Когда ИИ пишет скрипты для build123d, он работает «вслепую» — он не видит создаваемую геометрию. Этот сервер замыкает цикл обратной связи: ИИ может создавать геометрию, визуализировать виды, запрашивать размеры и находить ошибки постепенно, вместо того чтобы писать полные скрипты в надежде, что они верны.

Related MCP server: 3D MCP Server

Инструменты

• execute — выполнение Python-кода build123d в постоянной сессии; используйте show(shape, name) для регистрации именованных деталей

• render_view — рендеринг одной или нескольких фигур в формате PNG или SVG; поддерживает композицию сборок, высококачественную тесселяцию и плоскости сечения

• measure — запрос ограничивающей рамки (bounding box), объема, площади поверхности, топологии, минимальной толщины стенки или зазора между двумя именованными телами

• export — экспорт в STEP, STL или оба формата за один вызов; применяется к именованному объекту или текущей фигуре

• session_state — полный JSON-снимок активных фигур, именованных объектов и имен снимков

• health_check — проверка работоспособности зависимостей VTK/SVG/STEP/STL перед началом работы

• save_snapshot / restore_snapshot / diff_snapshot — создание контрольных точек, восстановление и сравнение геометрического состояния

• interference — проверка объема пересечения между двумя именованными фигурами

• list_objects — список всех именованных фигур со статистикой геометрии

• version — возврат версии сервера

• reset — сброс сессии до пустого состояния

Полное описание инструментов и примеры использования см. в llms.md.

Требования

• uv

• MCP-совместимый клиент (Claude Code, Claude Desktop, Cursor и т. д.)

Все зависимости Python (build123d, vtk и т. д.) устанавливаются автоматически с помощью uv.

Установка

Клонирование не требуется. Установите напрямую из PyPI:

pip install build123d-mcp

Или просто используйте uv tool run — это загружает и запускает пакет за один шаг без предварительной установки (см. ниже).

Добавление в MCP-клиенты

Сервер работает через stdio — клиент запускает его как подпроцесс с помощью uv tool run build123d-mcp.

Примечание о версии Python. Все примеры ниже используют --python 3.12. VTK и cadquery-ocp пока не предоставляют колеса (wheels) для Python 3.13+, поэтому требуется фиксация версии 3.12. uv автоматически загрузит управляемый Python 3.12, если у вас его еще нет.

Claude Code

Добавьте в .mcp.json вашего проекта (или ~/.claude/mcp.json для глобального использования):

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

После редактирования перезапустите Claude Code. Инструменты появятся автоматически после подключения.

Claude Desktop

Отредактируйте ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) или %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

После сохранения перезапустите Claude Desktop.

Cursor

Откройте Settings → MCP и добавьте новую запись сервера или отредактируйте ~/.cursor/mcp.json:

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

VS Code (GitHub Copilot / Continue)

Для расширения Continue добавьте в .continue/config.json:

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

Для GitHub Copilot с поддержкой MCP добавьте в .vscode/mcp.json в вашей рабочей области:

{
  "servers": {
    "build123d-mcp": {
      "type": "stdio",
      "command": "uv",
      "args": ["tool", "run", "--python", "3.12", "build123d-mcp"]
    }
  }
}

Системный промпт

Для достижения наилучших результатов вставьте содержимое default_prompt.md в качестве системного промпта в вашем ИИ-клиенте. Это даст ассистенту указание работать итеративно, проверять геометрию после каждого шага и использовать инструменты в правильном порядке.

Статус

Активная разработка (v0.1.0).