arielshad / 3d-asset-server

**3d-asset-server** searches 24 asset sites at once and downloads what you pick, ready to drop
into a game or a website. Use it from a browser, from `curl`, from the command line, or let your AI
assistant drive it over MCP.
> *"I need a low-poly tree pack, a mossy rock material and a sunset HDRI for my Three.js scene."*
>
> Your assistant calls `search_assets` three times, shows you the options with their licences, and
> `download_asset` puts glTF, textures and the HDRI into your project's `assets/` folder.
- **One query, many sources.** Results are merged and ranked, with a status line for every site.
- **Real downloads.** From free sources you get files directly: glTF with its `.bin` and textures,
 PBR maps at the resolution you ask for, HDRIs, or zipped packs (extracted for you).
- **Licence first.** Every result says what licence it has, whether it is free, and whether you
 must credit the author.
- **Honest about what's blocked.** Sites that block bots come back as links to their own search,
 so you still know where else to look.
---
## Contents
- How it works
- Sources
- Quick start
- Web UI (and for AI agents)
- MCP: use it from an AI assistant
- HTTP API
- CLI
- Downloads
- Configuration
- Project layout
- Development
- Licences & etiquette
---
## How it works
What a single search does:
A slow or broken site never fails the search. It shows up in the per-site report with its error
and a link to the same search on that site.
---
## Sources
| Source | Best for | Search | Direct download | Licence |
|---|---|---|---|---|
| Poly Haven | HDRIs, PBR textures, scanned models | API | yes: glTF / blend / fbx, maps, HDR / EXR | CC0 |
| ambientCG | Realistic materials, HDRIs, models | API | yes: per-resolution zips | CC0 |
| CGBookcase | PBR textures | API (catalogue) | no: hotlink-protected CDN, links to the download page | CC0 |
| ShareTextures | Textures and realistic models | API (tag search) | no: its licence forbids automated downloads | CC0 + site terms |
| BlenderKit | Blender assets of every kind | API | yes for free assets (GLB / blend); paid ones need `BLENDERKIT_API_KEY` | CC0 / royalty free |
| Fab | Game assets, environments, characters | link only (bot wall) | no | per listing |
| Kenney | Low-poly 3D, 2D, UI and audio packs | scrape | yes: pack zips, auto-extracted | CC0 |
| Poliigon | Premium materials and models | link only (bot wall) | no | per listing |
| Quaternius | Low-poly models, animated characters | scrape | no: Google Drive / itch.io links | CC0 / QAL |
| Polyfork | Low-poly models and themed kits for web and games | API | yes for free assets (GLB from Polyfork's CDN); FBX / USDZ / OBJ need an account | royalty free, no redistribution |
| 3DAssets.dev | Web-optimised GLB models: props, nature, buildings, vehicles | API | yes: GLB from its CDN | CC0 |
| Sketchfab | Community 3D models: scans, props, characters (CC0 subset) | API | no: downloads need a Sketchfab login | CC0 |
| Wikimedia Commons | STL scans, anatomy, recons