SolidCraft MCP

MCP-сервер для CAD-моделирования в SolidCraft: агент строит параметрические 3D-детали, измеряет объем и центр масс, смотрит скриншот и экспортирует в STEP

  • 11 834 ★ репозитория
  • Последний коммит
  • Apache-2.0
MCP-серверОфициальный

Широкий доступ

Почему такой уровень

  • Может читать, перезаписывать и удалять файлы в разрешенных папках: открытый проект, папка восстановления, пути из `--allow-path`; ключ `--allow-any-path` снимает предел
  • Запускает движок на видеокарте и выполняет любые команды САПР через `execute` и `batch`, а `new_design` и `open` отбрасывают несохраненную работу
Все причины и проверки

tangency-labs/solidcraft

Установка

Ручная установка

claude mcp add solidcraft -- solidcraft-cli mcp

Нужен исполняемый файл solidcraft-cli в PATH. Режим без окна, скриншоты рисуются на видеокарте или программно.

Доступ и проверки

Как мы проверяем

Широкий доступИнструмент может менять данные, выполнять команды или работать с секретами.

  • Может читать, перезаписывать и удалять файлы в разрешенных папках: открытый проект, папка восстановления, пути из `--allow-path`; ключ `--allow-any-path` снимает предел
  • Запускает движок на видеокарте и выполняет любые команды САПР через `execute` и `batch`, а `new_design` и `open` отбрасывают несохраненную работу

Это чужой код. Посмотрите файлы в репозитории перед установкой.

Что делает

SolidCraft — открытая параметрическая CAD-программа на Rust для настольных систем и браузера. Ее MCP-сервер для 3D-моделирования запускает команда `solidcraft-cli mcp`. Агент строит деталь теми же командами движка, которыми пользуются панель инструментов, скрипты и канал управления: эскиз с размерами и связями, выдавливание, вращение, скругления, оболочка, отверстия, массивы, параметры с формулами. Диалогов сервер не открывает. Инструментов пятнадцать. Для обзора и правки служат `list_commands`, `execute`, `batch` и `inspect_design`, для проверки результата `measure` и `body_topology`, `set_parameter` меняет размер, `screenshot` возвращает картинку, `export` пишет файл. Остальное: `undo`, `redo`, `new_design`, `open`, `save` и `crash_reports`. Пакет `batch` выполняется целиком или откатывается к началу, и ответ называет шаг, на котором произошла ошибка. Сервер работает в двух режимах. Автономный запускается командой `solidcraft-cli mcp` и держит собственный сеанс без окна, а скриншоты рисует на видеокарте. Подключенный режим запускается с `--connect 127.0.0.1:PORT` и управляет открытым приложением, которое стартовало с `solidcraft --control PORT`, и вы видите, как агент строит деталь.

Для кого. Для конструкторов, инженеров и мастеров 3D-печати, которые хотят поручить агенту параметрические детали вроде кронштейнов и корпусов и проверить их числами.

Подходит, если

  • Нужен корпус, кронштейн, фланец или пластина с параметрами: агент задает размеры, а изменение высоты в таблице параметров пересобирает всю деталь
  • Результат нужно проверить числами: `measure` возвращает объем, площадь, центр масс и габариты, а агент сверяет их с расчетом
  • Хочется смотреть, как агент моделирует: приложение запускают с `--control` и подключают сервер флагом `--connect`
  • Деталь нужна в формате STEP, STL, 3MF или OBJ для передачи в производство или печать, а сборку с шарнирами можно выгрузить в URDF

Не подходит, если

  • Нужна промышленная точность без оговорок: проект ранний, а полную геометрическую эквивалентность проверки не доказывают
  • Работа идет в FreeCAD: для него есть отдельный freecad-mcp, а SolidCraft имеет собственный движок и формат `.solidcraft`
  • Нужны чертежи в AutoCAD или GstarCAD: для них подойдет CAD-MCP Server
  • Нужен фотореалистичный рендер: HDRI, преломление и карты текстур в программе не реализованы
  • Папка вашего проекта лежит вне домашней папки или в скрытой: сервер не пускает туда запись, пока вы не добавите `--allow-path`

Пример запроса к агенту

Построй в SolidCraft корпус для Raspberry Pi 4 с параметрами длины, ширины и высоты, скруглениями, стойками под крепления и вырезами портов, проверь объем и выгрузи в STEP

MCP

Транспорт
stdio
Авторизация
не нужна

Переменные окружения

SOLIDCRAFT_CONTROL_TOKEN секрет
Токен канала управления приложением, нужен в подключенном режиме, если сервер не видит папку данных приложения
SOLIDCRAFT_GPU
Выбор способа отрисовки скриншотов: auto, hardware, software или cpu

Ограничения

  • Статус проекта: ранний, но пригодный для простых деталей. Из 76 открытых эталонных деталей 75 совпали с аналитическими или рассчитанными во FreeCAD значениями, оставшаяся — известная ошибка. Полную геометрическую эквивалентность эти проверки не доказывают.
  • Инструменты `execute`, `batch`, `open`, `save`, `export` и `screenshot` с путем могут читать, перезаписывать и удалять файлы, поэтому помечены как разрушающие. Сервер пускает их только в папку открытого проекта внутри домашней, папку восстановления и пути из `--allow-path`. Ключ `--allow-any-path` снимает ограничение.
  • Подключенный режим отдает токен через файл приложения или переменную `SOLIDCRAFT_CONTROL_TOKEN`. Скриншот приложение пишет во временный файл, и сервер читает его с диска, поэтому оба процесса должны стоять на одной машине.
  • Установщики пока без подписи: SmartScreen на Windows предупреждает, на macOS приложение при первом запуске открывают через контекстное меню. Отдельный архив `solidcraft-cli` в релизе 0.15.0 лежит для macOS, для остальных систем в документации описана сборка из исходников через `cargo`.
  • Лицензия MIT или Apache-2.0 на выбор. Проект независим и не связан с Autodesk.

Как отключить. Выполните `claude mcp remove solidcraft` или удалите блок `solidcraft` из `.mcp.json` или `claude_desktop_config.json` и перезапустите клиент. Если вы копировали скиллы, удалите папки `solidcraft-modeling`, `solidcraft-editing`, `solidcraft-checking` и `solidcraft-mechanisms` из `~/.claude/skills/`. Сохраненные файлы `.solidcraft` остаются на диске.

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

Как подключить SolidCraft к Claude Code для 3D-моделирования?

Положите `solidcraft-cli` в доступное место и выполните `claude mcp add solidcraft -- solidcraft-cli mcp`. Для Claude Desktop добавьте в `claude_desktop_config.json` сервер с командой `solidcraft-cli`, аргументами `mcp`, `--connect` и адресом работающего приложения.

Можно ли смотреть, как агент моделирует в окне SolidCraft?

Да. Запустите приложение командой `solidcraft --control 7878`, а сервер подключите флагом `--connect 127.0.0.1:7878`. Токен сервер найдет в файле, который приложение пишет для этого порта, а при запуске в песочнице его задает `SOLIDCRAFT_CONTROL_TOKEN`.

Какие скиллы идут с SolidCraft для агента?

В папке `skills/` четыре скилла: `solidcraft-modeling` для новой детали, `solidcraft-editing` для правки готовой, `solidcraft-checking` для проверок и переноса, `solidcraft-mechanisms` для сборок с шарнирами и движением. Для Claude Code их копируют в `~/.claude/skills/`. С ними агент строит деталь за несколько вызовов `batch`.

К каким файлам на компьютере получает доступ агент через SolidCraft?

Только к папке открытого проекта, если она внутри домашней и не скрытая, к папке восстановления SolidCraft и к путям из `--allow-path`. Каталоги вроде `~/.ssh` и `~/.aws` недоступны, ссылки и `..` разрешаются перед проверкой пути, а на Windows запрещены сетевые и служебные пути.

Как проверить, что деталь построена правильно?

Вызовите `measure`: он возвращает объем в мм³, площадь, центр масс, габариты и число граней, ребер и вершин. Навыки советуют заранее посчитать ожидаемые числа и сверять каждый этап, а `body_topology` помогает выбрать ребра и грани для скруглений по координатам.

Обсуждение

Вопросов и отзывов пока нет.

MCP-серверы
Официальный

Удаленный MCP-сервер браузерного CAD PartMode: агент правит параметрические детали, сборки и чертежи

MCP-серверРасширенный доступ505Звезды репозитория
Российский стек

MCP-сервер, CLI-утилита и скилл для платформы разработки SourceCraft от Яндекса: репозитории, issues, pull requests, CI/CD и релизы, 48 инструментов

MCP-серверШирокий доступ

SolidWorks Automation Skill

solidworks-automation-skill

Скилл и набор MCP для автоматизации настольных CAD (SolidWorks, AutoCAD): агент вызывает настоящую программу и проверяет результат. Windows, README на китайском

СкиллРасширенный доступ1,6 тыс.Звезды репозитория
Официальный

Экспериментальный MCP-сервер Structurizr: проверяет модель C4 в DSL, экспортирует виды в Mermaid и PlantUML и работает с рабочими пространствами на сервере

MCP-серверШирокий доступ507Звезды репозитория

Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их

ПлагинРасширенный доступ10,8 тыс.Звезды репозитория

MCP-сервер для проектирования печатных плат в KiCAD: агент размещает компоненты, разводит связи, проверяет DRC и готовит файлы на производство

MCP-серверРасширенный доступ3 тыс.Звезды репозитория

Сравнение с похожими

Записи с тем же главным запросом: чем они отличаются.

ЗаписьОфициальныйАвторизацияЗвезды репозиторияГлавное отличие
SolidCraft (эта запись)дане нужна11 834
FreeCAD MCPнетне нужна3 108управляет уже установленным FreeCAD через аддон и RPC-сервер, исполняет Python-код внутри него
CAD-MCP Serverнетне нужна650чертит и правит чертежи в AutoCAD, GstarCAD и ZWCAD обычными словами
text-to-cadнет24 136библиотека скиллов для CAD, CAE и CAM с экспортом STEP, STL, 3MF и нарезкой в g-code

Коротко о README

Главная страница репозитория открывается кнопками загрузки для Windows, macOS, Linux и браузера, затем перечисляет возможности: эскизы с решателем связей, параметрическую ленту операций, сборки, листовой металл, экспорт и импорт форматов, настольное приложение и консольный `solidcraft-cli`. Раздел про агентов описывает MCP-сервер, а папка `skills/` содержит четыре скилла с руководством по установке. Рядом лежат дорожная карта, документация в виде книги и тесты сверки с эталонными деталями.

Бейдж для README

Сообщить о проблеме

Foxx AISolidCraft
Foxx AI

Я Foxx AI и уже разобрал этот инструмент. Спросите про установку, настройку или что угодно еще, отвечу простыми словами.