Sozai Search Mcp

Free 3D assets for AI agents: search ~36,000 free (mostly CC0) models, materials and HDRIs with real-world sizes, as an MCP server

LLM Mart 2 views 90 listing impressions

English | 日本語 | 简体中文 | 한국어 | Português | Español

Quick start · Tools · Sources · Semantic search · FAQ · ⭐ Star

Sozai Search MCP gives Claude Code, Claude Desktop, Cursor and any other MCP client a library of 39,000 free 3D assets: photoreal models, PBR materials and HDRIs from Poly Haven and ambientCG, low-poly game models from Kenney, Quaternius, KayKit and Polygonal Mind, rigged VRM avatars from Open Source Avatars, NASA spacecraft, rovers and telescopes, and Quixel Megascans listings. Ask for "a wooden crate under 1 m tall" or "a mossy rock"; the agent searches by words or by meaning, looks at the previews, and drops the files into your project, at their real size in metres. (Sozai, 素材, means "materials" in Japanese.)

Sozai Search is an index. It hosts no asset files: every result points at the official source, and files are downloaded from there by your own machine.

✨ Highlights


Search
Keywords and synonyms, or meaning in any language ("苔むした岩" finds mossy rocks)

Real sizes
Every size in metres; filter by largest dimension, height and polycount

Ready to use
One .glb per model, PBR folders, HDRIs, plus CREDITS.md

Free
Mostly CC0; redistributable_only keeps what you may ship
  • Looks before it picks: view_assets shows the agent up to 8 previews, so it chooses by eye, not by title.
  • Arrives at the right size: kit models are calibrated to metres (a door is 2.1 m, a person 1.75 m) and delivered already scaled; rigs and animations keep working.
  • Light: the server is standard-library Python with no runtime dependencies. It starts in about 25 ms, idles at about 23 MB and holds no state between calls.
  • Safe with untrusted data: https only, to the libraries' own hosts; every path stays inside the folder you gave; it never deletes your files.

🧭 How it works

"a wooden crate under 1 m tall"
   └─ search_assets   keywords + meaning, filtered by kind, size, height, polycount, licence
   └─ view_assets     the agent looks at the candidates' previews
   └─ fetch_asset     downloads from Poly Haven / ambientCG (or your local kit zip),
                      packs one .glb at real scale, appends the credit to CREDITS.md

sozai build downloads the published data once: one zip with every library's records (what each asset is, its size, licence and where to get it) and the search vectors. No asset files, no previews.

🚀 Quick start

🤖 Install with your AI agent

Give this repository's URL to Claude Code, Codex or another agent and ask it to install Sozai Search MCP. These are the steps it should follow (they work by hand too):

  1. uv: check uv --version; if uv is missing, install it:

    • macOS / Linux: curl -LsSf https://astral.sh/uv/install.sh | sh
    • Windows: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  2. Register the server: run this in the user's own project folder. No clone is needed: uv fetches Sozai Search from GitHub.

    # Claude Code: this project only (writes .mcp.json)
    claude mcp add sozai -s project -- uvx --from git+https://github.com/kanaworksai-hue/sozai-search-mcp sozai
    

From the project's README.

Related servers

Read and write RAGE Package Format archives

23 views

Let LLM help you achieve your regression analysis with Stata

21 views

Web search, deep research, prediction markets & crypto data for AI agents. Pay per call via x402.

21 views

vSphere with Tanzu (VKS): Namespace and TanzuKubernetesCluster lifecycle. Requires vSphere 8.x+.

20 views