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
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_assetsshows 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):
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"
- macOS / Linux:
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.