Young Tries AI

Give Claude Code a library of 39,000 free 3D assets with Sozai Search MCP

This guide is for creators and developers who are comfortable with a terminal. You register Sozai Search MCP in a project, then ask Claude Code to find and fetch a 3D asset.

Skills and MCPFor creators, developers

Before you start

  • Claude Code installed (Codex, Claude Desktop and Cursor also work with the same server).
  • A terminal and a project folder where the 3D files should land.
  • uv, which brings Python 3.10 or newer. The guide installs it if it is missing.
  • About 15 MB of disk for the published data, plus about 600 MB only if you turn on optional semantic search.
  1. Run the command in the copy box to see if uv is installed. If the terminal says uv is not found, install it with the command for your system. On Windows, use the PowerShell command instead.

    Run in the terminal
    uv --version
  2. Run the command in the copy box in a terminal, but only if uv was missing. Windows users run the PowerShell command instead of this one.

    Run in the terminal
    curl -LsSf https://astral.sh/uv/install.sh | sh
  3. Open a terminal in your own project folder and run the Claude Code command. You do not need to clone anything, because uv fetches Sozai Search from GitHub. The command writes a .mcp.json for this project only.

    Run in the terminal
    claude mcp add sozai -s project -- uvx --from git+https://github.com/kanaworksai-hue/sozai-search-mcp sozai
  4. MCP servers load when a session starts, so open a new Claude Code session in the project. Claude Code asks once to approve the project's .mcp.json. Then run the command in the copy box to check that the server is listed.

    Run in the terminal
    claude mcp list
  5. Paste the request into Claude Code. The first search downloads the published data (about 15 MB) and builds the index in a few seconds. The fetch tool needs an absolute folder inside the project, so the request names one.

    Paste into Claude Code
    Search Sozai for a wooden crate under 1 m tall, look at the previews, pick the best one, and fetch it into an assets folder inside this project (use the absolute path).
  6. Semantic search improves descriptive queries and queries in any language. In the source's tests, the right asset came first 79% of the time instead of 31%. It needs about 600 MB of disk once, so only turn it on if you want it. Start by running the command to download the query model.

    Run in the terminal
    uvx --from "sozai-search-mcp[semantic] @ git+https://github.com/kanaworksai-hue/sozai-search-mcp" sozai semantic-setup
  7. Register the server again, this time with the --from value replaced by the semantic one. Run the command in the copy box in your project folder.

    Run in the terminalExample assembled from the docs
    claude mcp add sozai -s project -- uvx --from "sozai-search-mcp[semantic] @ git+https://github.com/kanaworksai-hue/sozai-search-mcp" sozai

Watch out for

  • MCP servers load only when a session starts, so open a new session after you register the server.
  • Sozai Search is an index and hosts no asset files. Your own machine downloads the files from the official sources, such as Poly Haven and ambientCG.
  • Give the fetch tool an absolute folder inside the project. Paths stay inside the folder you gave.
  • Most assets are CC0, but not all. Use the redistributable_only option to keep only assets you may ship. Each credit is appended to CREDITS.md.
  • On Windows, install uv with the PowerShell command from the README instead of the curl command.

Questions

Does Sozai Search MCP work outside Claude Code?
Yes. Codex has its own codex mcp add command. Claude Desktop, Cursor and other MCP clients take the same command in their JSON config.
What files does Sozai Search MCP return?
You get one .glb per model, PBR folders, HDRIs and a CREDITS.md. Kit models are calibrated to real size in metres (a door is 2.1 m, a person 1.75 m) and arrive already scaled.
Is the Sozai Search server heavy to run?
No. The server is standard-library Python with no runtime dependencies. It starts in about 25 ms and idles at about 23 MB.
Can Sozai Search MCP delete my files?
The README says it never deletes your files. It also says it uses https only to the libraries' own hosts and keeps every path inside the folder you gave.

Sources