threecrate — 3D-сканы и сетки для агента
threecrate
Скилл и MCP-сервер на Rust: агент чистит облако точек, закрывает дыры, строит сетку и сохраняет STL, готовый к 3D-печати
- 52 ★ репозитория
- Последний коммит
Расширенный доступ
Почему такой уровень
- Инструменты читают и создают файлы в рабочей папке, а скилл запускает скрипты Python и ставит пакет в окружение
- Исходные сканы не перезаписываются без явного `overwrite`=`true`
Установка
- Работает в
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/threecrateОпределит агенты на машине, покажет уровень доступа и зафиксирует версию.
Другие способы установки
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Инструменты читают и создают файлы в рабочей папке, а скилл запускает скрипты Python и ставит пакет в окружение
- Исходные сканы не перезаписываются без явного `overwrite`=`true`
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
threecrate — библиотека на Rust с привязками для Python для обработки облаков точек и сеток. Вокруг нее сделаны скилл и MCP-сервер threecrate-mcp, чтобы агент справлялся со сканом по просьбе вроде «сделай table_scan.ply пригодным для печати». Он чистит лишние точки, убирает пол, закрывает отверстия, добавляет основание, проверяет результат по картинке и пишет STL. Сервер дает инструменты inspect_point_cloud, inspect_mesh, `convert`, `downsample`, remove_outliers, estimate_normals, `register`, `transform`, segment_plane, extract_clusters, `reconstruct`, simplify_mesh, smooth_mesh, `render` и repair_for_print. Инструмент `render` рисует облако или сетку с пяти ракурсов в один PNG без видеокарты, а дыры и вывернутые грани подсвечивает оранжевым. Скилл сначала измеряет скан и подбирает размер вокселя и радиусы по расстоянию между точками. Инструменты работают в одной рабочей папке и пишут результат в новый файл рядом с исходным, ничего не перезаписывая. Отвечают они сводками, а сами точки остаются в файлах и не забивают контекст.
Для кого. Тем, кто печатает на 3D-принтере по сканам с телефона или лидара, и инженерам, которые выравнивают и очищают облака точек без Blender и MeshLab.
Подходит, если
- Скан со смартфона не проходит слайсер из-за дыр, стола в кадре и вывернутых граней
- Перед печатью надо проверить, пригодна ли деталь в part.stl и что с ней не так
- Два скана одного объекта нужно совместить без заданного начального положения
- Требуется отделить пол или стену от облака и разделить его на отдельные объекты
- Нужна сетка по облаку точек и упрощение числа треугольников
Не подходит, если
- Нужны CAD-модели с параметрами и сборками: threecrate обрабатывает сканы и сетки, параметрических деталей в нем нет
- Формат облака вне PLY, PCD, XYZ и CSV: запись другими форматами в сервере не заявлена
- Облако больше 50 миллионов точек: по умолчанию сервер его отклонит
- Нужна ручная скульптура и текстуры, как в Blender
Пример запроса к агенту
Сделай table_scan.ply пригодным для печати: убери стол, закрой дыры, добавь основание и покажи картинку до и после.MCP
- Транспорт
- stdio
- Авторизация
- не нужна
Переменные окружения
THREECRATE_MCP_ROOT- Рабочая папка со сканами, то же, что ключ --root
THREECRATE_MCP_MAX_POINTS- Предел числа точек, по умолчанию 50 миллионов
Ограничения
Сервер читает и пишет облака в PLY, PCD, XYZ и CSV, а сетки в PLY, OBJ и STL. Облака больше 50 миллионов точек он отказывается брать, лимит меняют ключом --max-points. Нужны uv или Python 3.10 и новее, скиллу достаточно Python 3.8, и первый раз агент ставит threecrate в виртуальное окружение.
Выигрыш 1,5–3,4 раза над Open3D автор измерял на Windows, в контейнере Linux картина иная. Форматы LAS, LAZ и E57 в библиотеке включаются отдельными флагами сборки. Клиентам вроде Claude Desktop и Cursor нужно явно указать --root с папкой сканов.
Как отключить. Для Claude Code выполните claude mcp `remove` threecrate, плагин снимает claude plugin `uninstall` threecrate@threecrate. Файлы сканов не меняются, потому что результаты пишутся в новые файлы.
Частые вопросы
Чем отличаются скилл и MCP-сервер?
Скилл учит агента решать задачу короткими скриптами на Python и ведет по руководствам: очистка, совмещение, печать. MCP-сервер дает те же операции готовыми инструментами. Выбирайте сервер, если не хотите, чтобы агент запускал скрипты.
Как поставить threecrate в Claude Code?
Плагин ставят командами claude plugin marketplace add rajgandhi1/threecrate и claude plugin install threecrate@threecrate. Для сервера хватит claude mcp add threecrate -- uvx threecrate-mcp. Для Codex и Gemini CLI в README есть свои команды.
Что делает repair_for_print?
Берет облако точек или сетку и возвращает водонепроницаемый STL с отчетом по шагам: убирает мусор и пол, закрывает отверстия, добавляет основание, выправляет направление граней. Перед работой analyze_mesh показывает, что сломано.
Может ли сервер перезаписать мой скан?
Нет. Результат идет в новый файл рядом с исходным, например scan.downsampled.ply. Перезапись разрешена только при `overwrite`=`true`, а инструменты ходят только внутри рабочей папки.
Нужна ли видеокарта?
Для `render` и обычных операций нет: картинка рисуется без GPU. Ускорение на видеокарте есть в отдельном крейте `threecrate-gpu` на `wgpu`, но сервер и скилл от него не зависят.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыЛокальный MCP-сервер и CLI: агент пишет JavaScript для 3D-модели, получает рендеры и проверки, а на выходе GLB и исходник
Три скилла для Meshy CLI: агент делает 3D-модели по тексту и фото, текстурирует и готовит их к 3D-печати
Открытый MCP-сервер для 3D-печати: агент проектирует деталь, нарезает, ставит на печать и следит за принтером
Удаленный MCP-сервер с 40 инструментами: 3D-модель по тексту или фото, риггинг, анимация, ретекстурирование и проверка GLB
Скилл пересобирает объект с референсного изображения в процедурную 3D-модель Three.js, написанную кодом, а не скачанную
Симулятор масляной живописи на Rust и мольберт с MCP-адаптером: агент рисует кистями, смешивает краски на палитре и смотрит холст
Сравнение с похожими
Карточки с тем же главным запросом: чем они отличаются.
| Инструмент | Официальный | Авторизация | Звезды репозитория | Главное отличие |
|---|---|---|---|---|
| threecrate — 3D-сканы и сетки для агента (эта карточка) | нет | не нужна | 52 | |
| OpenSCAD MCP | нет | не нужна | 170 | параметрическое моделирование в OpenSCAD, у threecrate вход идет от сканов |
| Blender Agent Skills | нет | 1 014 | работа через Blender, а здесь сканы обрабатываются без него |
Коротко о README
README ставит четыре проблемы работы со сканами: непечатные сканы, слепота агента к 3D, подбор параметров на глаз и тяжесть Open3D и PCL. Дальше идут справочник по Python и Rust, таблица крейтов, сравнение с Open3D и PCL и ссылки на документацию. Отдельный README у threecrate-mcp перечисляет инструменты.