sand3d-mcp
Connects to the Sand3D 3D object catalog hosted on Hugging Face, enabling semantic or keyword search, similar-object lookup, object metadata and program retrieval, and downloading GLB/USDA models with renders and attribution data. It also references Hugging Face datasets for bulk access.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@sand3d-mcp Find a wooden rocking chair and download it to assets/sand3d"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
sand3d-mcp
MCP-сервер для открытого каталога 3D-объектов Sand3D от Sandflow. В каталоге около 100 тысяч объектов. У каждого есть GLB, рендер и короткая Python-программа, которая этот объект строит. Лицензия CC BY 4.0.
Сервер подключается к любому MCP-клиенту (Claude Code, Claude Desktop, Cursor и другие). Модель ищет объект по описанию, выбирает его глазами по контактному листу с рендерами и скачивает в папку проекта.
Сервер неофициальный и с Sandflow не связан.
Что умеет
Инструмент | Что делает |
| Поиск по смыслу (английское описание сравнивается с рендерами) или по словам. Фильтры по датасету, семейству, шарнирам. Возвращает список и контактный лист с номерами |
| Похожие по виду на выбранный объект, тоже с листом |
| Карточка объекта с лицензией, атрибуцией, ссылкой на страницу и его программа |
| Скачивает |
| Датасеты и семейства со счетчиками |
| Справка по устройству GLB и шарнирам. То же доступно ресурсом |
Все инструменты только читают каталог. Пишет на диск один download_object, и только в папку, которую назвали в запросе.
Related MCP server: sketchfab-mcp-server
Установка
Нужен uv или Python 3.10 и новее. Отдельно ставить ничего не нужно, uvx сам соберет окружение при первом запуске.
Проверка, что сервер запускается.
uvx --from git+https://github.com/siliconbag/sand3d-mcp sand3d-mcpСервер молча ждет команд на stdin, выход по Ctrl+C. Из локальной копии репозитория запуск такой.
uvx --from /path/to/sand3d-mcp sand3d-mcp
# или
pip install /path/to/sand3d-mcp && sand3d-mcpПодключение
Claude Code
claude mcp add sand3d -- uvx --from git+https://github.com/siliconbag/sand3d-mcp sand3d-mcpФлаг --scope user подключит сервер во всех проектах. Относительные пути в download_object считаются от папки, где запущен Claude Code.
Claude Desktop
Файл claude_desktop_config.json (Settings, Developer, Edit Config).
{
"mcpServers": {
"sand3d": {
"command": "uvx",
"args": ["--from", "git+https://github.com/siliconbag/sand3d-mcp", "sand3d-mcp"]
}
}
}Если Claude Desktop не находит uvx, укажи полный путь (его покажет which uvx). Рабочая папка у Desktop не определена, поэтому для скачивания называй абсолютный путь.
Cursor
Файл .cursor/mcp.json в проекте или ~/.cursor/mcp.json для всех проектов.
{
"mcpServers": {
"sand3d": {
"command": "uvx",
"args": ["--from", "git+https://github.com/siliconbag/sand3d-mcp", "sand3d-mcp"]
}
}
}Примеры запросов к модели
«Найди в Sand3D старый красный трактор и скачай лучший вариант в
assets/sand3d»«Нужна настольная лампа с подвижными частями для three.js сцены. Положи модель и помощник для шарниров в
public/models»«Покажи, какие семейства есть в датасете simready»
«Найди что-нибудь похожее на этот объект, но в другом стиле»
«Открой программу этого объекта и скажи, какие у него параметры»
Смысловой поиск понимает английский. Модель сама переводит запрос, но точнее всего работает описание внешнего вида («wooden rocking chair», «yellow forklift»).
Что лежит в папке после скачивания
model.glb, объект в метрах, ось Y вверх, корень со scale 0.001program.py, программа на библиотеке sand3d, которая строит объектrender.png, рендер 512x512 на прозрачном фонеmeta.json, имя, датасет, семейство, лицензии, строка атрибуции, габариты, детали и шарнирыmodel.usda, если попросили или если у объекта нет GLBs3d-joints.js, если попросили помощник для three.js (collectJoints,setJoint,setJoint01,fitToHeight)
Лицензии
Каталог Sand3D выпущен Sandflow под CC BY 4.0. У исходных моделей свои лицензии, они записаны в meta.json в полях source_license и license_status. При публикации ролика, сайта или игры с объектом указывай строку attribution из meta.json.
Код этого сервера распространяется по лицензии MIT, см. LICENSE.
Бережно к чужому сервису
Сервер ходит в публичный API спейса Sandflow, который работает на одном CPU. Десятки объектов это нормально. Для массовой выгрузки бери открытые датасеты Sandflow/sand3d-objaverse, -cad, -articraft, -simready, -automate на Hugging Face (parquet с программами, рендерами и USDA). Потолок выдачи 200 объектов за запрос, по умолчанию 12. Контактный лист рисует не больше 24 рендеров.
Ограничения
Все зависит от спейса Sandflow. Если его остановят или поменяют API, сервер перестанет работать.
Готовые GLB отдает только спейс, в открытых датасетах их нет.
Если спейс уснул, первый запрос ждет загрузки каталога до 4 минут. Некоторые клиенты обрывают вызов раньше, тогда просто повтори его через минуту. Время ожидания задается переменной
SAND3D_WAKE_SECONDS.Соединение со спейсом иногда рвется сериями по несколько секунд. Сервер повторяет запрос примерно 40 секунд, потом возвращает понятную ошибку.
Пересборка объекта из
program.pyтребует пакетаsand3dи Blender (bpy), сервер ее не делает.
English
Unofficial MCP server (stdio) for the open Sand3D 3D object catalog by Sandflow (about 100k objects with GLB, render and generating Python program, CC BY 4.0). Tools: search_objects (meaning or keyword search with a numbered contact sheet image), find_similar, get_object, download_object, list_datasets, sand3d_format_guide.
# Claude Code
claude mcp add sand3d -- uvx --from git+https://github.com/siliconbag/sand3d-mcp sand3d-mcpClaude Desktop or Cursor config:
{ "mcpServers": { "sand3d": { "command": "uvx", "args": ["--from", "git+https://github.com/siliconbag/sand3d-mcp", "sand3d-mcp"] } } }Please be gentle with the service, it is a single-CPU space: dozens of objects are fine, use the Hugging Face datasets Sandflow/sand3d-* for bulk work. Credit the attribution string from meta.json when you publish. Code is MIT licensed.
Available Tools
6 toolsdownload_objectAIdempotent
Download one Sand3D object into a folder the user chose: model.glb, program.py, render.png (512x512, transparent) and meta.json with license and attribution; model.usda too when include_usda=true or when the object has no GLB. Files go to /; existing files with the same names are overwritten. Returns paths, sizes, GLB stats (meters, Y up), part names, joints and the attribution string to credit (CC BY 4.0). include_threejs_helper=true also writes s3d-joints.js (collectJoints, setJoint, setJoint01, fitToHeight). Only writes inside the given directory. Runs against a free single-CPU space by Sandflow: fine for dozens of objects; for bulk work use the open Hugging Face datasets Sandflow/sand3d-*.
Inputs: directory (required), object_id (required), subfolder, include_usda, +1 more.
find_similarARead-onlyIdempotent
Find objects that look like a given Sand3D object (visual nearest neighbours). Returns a numbered list and a contact sheet image. Runs against a free single-CPU space by Sandflow: fine for dozens of objects; for bulk work use the open Hugging Face datasets Sandflow/sand3d-*.
Inputs: object_id (required), limit, same_dataset, contact_sheet.
get_objectARead-onlyIdempotent
Get the card of one Sand3D object: name, dataset, family, parts, joints, license, attribution string, page URL, and its generating Python program (sand3d library, millimeters, Z up). The program is cut to program_lines unless full_program=true.
Inputs: object_id (required), full_program, program_lines.
list_datasetsARead-onlyIdempotent
List Sand3D datasets (objaverse household items, cad mechanical parts, articraft articulated objects, simready warehouse assets, automate mechanical assemblies) with object counts and their families. Pass dataset to see all families of one dataset; family keys or labels can be used in search_objects.
Inputs: dataset.
sand3d_format_guideARead-onlyIdempotent
How Sand3D GLB files are built (meters, Y up, root scale 0.001, part names, materials), how joints are stored in extras.s3d_joint and how to move them in three.js, the program format, licenses and fair use. Read before writing code that loads a downloaded model.
Inputs: no named parameters.
search_objectsARead-onlyIdempotent
Search the Sand3D catalog (about 100k 3D objects with GLB, render and generating Python program, CC BY 4.0). Default mode compares an English text description with the renders (CLIP), so describe the look in English, e.g. 'old red farm tractor'. match_words=true does exact keyword search in names, families, attribution and program code. Returns a numbered text list with object ids and a contact sheet image with the same numbers; names repeat a lot, so pick by the image. Runs against a free single-CPU space by Sandflow: fine for dozens of objects; for bulk work use the open Hugging Face datasets Sandflow/sand3d-*.
Inputs: limit, query, family, offset, +6 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct role: text/visual catalog search (search_objects), visual nearest-neighbour lookup (find_similar), single-object metadata (get_object), file export (download_object), catalog structure (list_datasets), and reference docs (sand3d_format_guide). The only close pair, search_objects vs find_similar, is separated by input type (English description vs an existing object id) and both are explicitly documented. An agent can select correctly without guessing.
Five of six tools follow a clean verb_noun snake_case pattern (search_objects, find_similar, get_object, download_object, list_datasets). The exception is sand3d_format_guide, a noun-phrase documentation tool, which is a minor but understandable deviation since it is not an action on the catalog.
Six tools is well within the ideal 3-15 range and each earns its place: search, similarity, detail, download, dataset listing, and format guidance. There is no redundancy and no filler tool.
The surface covers the full discover-inspect-download lifecycle plus licensing/attribution info and a code-format guide, with bulk access routed to Hugging Face datasets. Minor gaps remain, such as no direct way to paginate or enumerate all objects in a family beyond keyword search, and no dedicated attribution/licence lookup separate from get_object.
Maintenance
Related MCP Connectors
Search a large 3D model library and download converted GLB/FBX/USDZ assets via signed URLs.
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
1Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Related MCP Servers
- AlicenseCqualityDmaintenanceAllows interaction with Sketchfab's 3D model platform through Claude or Cursor, enabling users to search, view details, and download 3D models directly from the AI interface.2499 npm46ISC
- FlicenseAqualityDmaintenanceEnables AI clients to search, browse, inspect, and download 3D models from Sketchfab via the Model Context Protocol.52-
- FlicenseAqualityDmaintenanceEnables AI agents to search and download 3D assets (models, materials, HDRs, brushes) from the BlenderKit library.21-
- AlicenseNot gradedqualityBmaintenanceAllows an AI assistant to search a local library of 3D-printable models, retrieve geometry metrics like dimensions, triangle counts, and watertightness, and draft marketplace listings.GPL 3.0