Skip to main content
Glama

Cozu

Free, game-ready 3D models for games, apps and film, at cozu.xyz. No account, no key. Models are under CC BY 4.0: use them in commercial work and credit each one with its line, which links back to its page on cozu.xyz.

This repository is the site, the API and the MCP server. The models themselves are not here: they live in Firebase Storage and are listed in src/content/assets/.

For agents and scripts

  • MCP server (Streamable HTTP): https://cozu.xyz/mcp

    claude mcp add --transport http cozu https://cozu.xyz/mcp

    Tools: search_assets, get_asset, get_attribution, list_categories.

  • JSON API: https://cozu.xyz/api/v1/assets.json, /api/v1/assets/{id}.json, /api/v1/search?q=, OpenAPI at /api/v1/openapi.json.

  • https://cozu.xyz/llms.txt, /llms-full.txt, and every model as Markdown at /assets/{id}.md.

Docs: cozu.xyz/developers.

Related MCP server: game-dev-resource-mcp

How it is built

  • Site: Astro, static output. Pages, the JSON API, OpenAPI, Markdown and llms.txt are all generated at build time from src/content/assets/*.json. Preview renders are pulled from Storage at build and turned into AVIF and WebP.

  • Design: the design-taste-frontend kit (MIT), copied unchanged into public/kit/, with the page's own CSS in src/styles/site.css. The 3D viewer (model-viewer, with the meshopt decoder in public/vendor/) loads only when someone asks for it.

  • Hosting: Firebase Hosting. Files: Firebase Storage, public read under assets/, immutable cache headers, one folder per model version.

  • Function: one Cloud Function (functions/, Node 22) serves /mcp and /api/v1/search. It reads the static catalog and caches it for five minutes.

src/content/assets/   one JSON file per model (metadata, file list with sizes and SHA-256)
src/lib/              site constants, licences, the catalog and its Markdown form
src/pages/            pages and the generated API endpoints
functions/            the MCP server and search
scripts/              publish-asset.mjs (upload a package to Storage), check-brackets.py
.github/workflows/     deploy.yml: deploy Hosting and the Cloud Function on every push to main
public/kit/           the design kit (MIT, see public/kit/LICENSE.txt)

Publishing a model

  1. Write src/content/assets/<id>.json (title, summary, description, licence, stats, previews, downloads).

  2. Upload the package and record its files:

    npm run publish-asset -- <id> <package folder> [zip file]

    This needs gcloud signed in to the project. It uploads to assets/<id>/<version>/ and writes the file list, sizes and checksums into the JSON.

  3. Commit and push to main. GitHub Actions builds the site and deploys it to Firebase Hosting, and deploys the Cloud Function when its code changed (.github/workflows/deploy.yml). The sitemap, JSON API, Markdown pages and llms.txt are regenerated on every build.

Storage rules are deployed by hand: npm run deploy.

Analytics

One Google Analytics property sees people, agents and bots, each hit labelled with a traffic user property (human, agent or bot) and a client_type (browser, ai_agent, ai_crawler, search_crawler, script, headless, link_preview, ...).

  • Pages: the Google Analytics tag in src/layouts/Base.astro, loaded after the page finishes. Events: search, view_3d, copy_credit. Cookies are off by default in the EEA, the UK and Switzerland.

  • Downloads, API, MCP: the Cloud Function counts each call and sends it with the Measurement Protocol (functions/track.js): download (every file URL goes through /dl/, which redirects to Storage), api_search, mcp_call.

  • Crawlers and agents reading pages or files: Hosting request logging is on; the log sink hosting-to-analytics sends entries to the Pub/Sub topic hosting-requests, whose push subscription hosting-requests-to-api delivers them to the function (/_ingest/hosting), which sends server_request for everything except people's page views (the tag counts those).

Secrets in Secret Manager: GA_MP_SECRET (Measurement Protocol key) and INGEST_TOKEN (shared with the push subscription). Every event is also written to Cloud Logging as a track <event> line.

Develop

npm install
npm run dev

Licence

The code in this repository is MIT (see LICENSE). The models are under the licence on their own pages, CC BY 4.0 unless stated, and are not part of this repository.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Provides AI assistants with access to Civitai's collection of AI models, enabling users to browse, search, and discover AI models through MCP-compatible AI assistants.
      14
      13
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables coding agents to search and select local 3D assets, textures, audio, and animations via MCP, using metadata like dimensions, themes, and availability without reading files from disk.
      3
      MIT