Skip to main content
Glama

sand3d-mcp

MCP-сервер для открытого каталога 3D-объектов Sand3D от Sandflow. В каталоге около 100 тысяч объектов. У каждого есть GLB, рендер и короткая Python-программа, которая этот объект строит. Лицензия CC BY 4.0.

Сервер подключается к любому MCP-клиенту (Claude Code, Claude Desktop, Cursor и другие). Модель ищет объект по описанию, выбирает его глазами по контактному листу с рендерами и скачивает в папку проекта.

Сервер неофициальный и с Sandflow не связан.

Что умеет

Инструмент

Что делает

search_objects

Поиск по смыслу (английское описание сравнивается с рендерами) или по словам. Фильтры по датасету, семейству, шарнирам. Возвращает список и контактный лист с номерами

find_similar

Похожие по виду на выбранный объект, тоже с листом

get_object

Карточка объекта с лицензией, атрибуцией, ссылкой на страницу и его программа

download_object

Скачивает model.glb, program.py, render.png, meta.json в указанную папку. По желанию model.usda и помощник s3d-joints.js для three.js

list_datasets

Датасеты и семейства со счетчиками

sand3d_format_guide

Справка по устройству GLB и шарнирам. То же доступно ресурсом sand3d://guide

Все инструменты только читают каталог. Пишет на диск один 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.001

  • program.py, программа на библиотеке sand3d, которая строит объект

  • render.png, рендер 512x512 на прозрачном фоне

  • meta.json, имя, датасет, семейство, лицензии, строка атрибуции, габариты, детали и шарниры

  • model.usda, если попросили или если у объекта нет GLB

  • s3d-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-mcp

Claude 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 tools
download_objectA
Idempotent

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_similarA
Read-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_objectA
Read-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_datasetsA
Read-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_guideA
Read-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_objectsA
Read-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

    A4.2/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers