SolidCraft MCP
MCP-сервер для CAD-моделирования в SolidCraft: агент строит параметрические 3D-детали, измеряет объем и центр масс, смотрит скриншот и экспортирует в STEP
- 11 834 ★ репозитория
- Последний коммит
- Apache-2.0
Широкий доступ
Почему такой уровень
- Может читать, перезаписывать и удалять файлы в разрешенных папках: открытый проект, папка восстановления, пути из `--allow-path`; ключ `--allow-any-path` снимает предел
- Запускает движок на видеокарте и выполняет любые команды САПР через `execute` и `batch`, а `new_design` и `open` отбрасывают несохраненную работу
Установка
- Работает в
Ручная установка
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 с параметрами длины, ширины и высоты, скруглениями, стойками под крепления и вырезами портов, проверь объем и выгрузи в STEPMCP
- Транспорт
- 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 и CLI для SourceCraft: репозитории и CI/CD
SourceCraft MCP Server
MCP-сервер, CLI-утилита и скилл для платформы разработки SourceCraft от Яндекса: репозитории, issues, pull requests, CI/CD и релизы, 48 инструментов
SolidWorks Automation Skill
solidworks-automation-skill
Скилл и набор MCP для автоматизации настольных CAD (SolidWorks, AutoCAD): агент вызывает настоящую программу и проверяет результат. Windows, README на китайском
Экспериментальный MCP-сервер Structurizr: проверяет модель C4 в DSL, экспортирует виды в Mermaid и PlantUML и работает с рабочими пространствами на сервере
Плагин со скиллами для сборки MCP-серверов и MCP-приложений на TypeScript: агент создает, дорабатывает, отлаживает и проверяет их
MCP-сервер для проектирования печатных плат в KiCAD: агент размещает компоненты, разводит связи, проверяет DRC и готовит файлы на производство
Сравнение с похожими
Записи с тем же главным запросом: чем они отличаются.
| Запись | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| 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/` содержит четыре скилла с руководством по установке. Рядом лежат дорожная карта, документация в виде книги и тесты сверки с эталонными деталями.