openusd-mcp

# openusd-mcp An MCP server that lets AI assistants read, inspect, and manipulate [OpenUSD](https://openusd.org) scenes. **[Live Demo](https://daslabhq.github.io/openusd-mcp/)** — interactive 3D viewer with variant switching ``` pip install openusd-mcp ``` ## What it does Connect this MCP server to Claude, ChatGPT, Cursor, or any MCP-compatible client. Your AI assistant can then work directly with `.usda`, `.usdc`, and `.usdz` files — inspecting scene graphs, querying properties, exporting meshes, and switching variants. ## Tools | Tool | Description | |------|-------------| | `usd_inspect` | Read the scene graph — list all prims, types, hierarchy | | `usd_get_prim` | Get detailed properties, attributes, and metadata for a specific prim | | `usd_get_materials` | List all materials and their shader parameters | | `usd_get_transforms` | Get world-space transforms for prims | | `usd_list_variants` | List all variant sets and their options | | `usd_set_variant` | Switch a variant selection | | `usd_export_mesh` | Export a mesh prim as STL or OBJ | | `usd_scene_stats` | Get scene statistics — prim count, mesh count, material count, bounding box | ## Quick start ### With Claude Desktop Add to your `claude_desktop_config.json`: ```json { "mcpServers": { "openusd": { "command": "openusd-mcp", "args": [] } } } ``` Then try it with the included example scenes: *"Inspect the scene graph of examples/desk_setup.usda and describe what's on the desk."* *"What color options does the product in examples/product_configurator.usda have? Switch it to gold."* ### With any MCP client ```bash openusd-mcp --stdio ``` The server communicates over stdin/stdout using the [MCP protocol](https://modelcontextprotocol.io). ## Examples The repo includes two example scenes that exercise all 8 tools. ### Desk setup — scene inspection A desk with a table, monitor, keyboard, and mug. 5 PBR materials (wood, metal, screen, ceramic, dark plastic), 10 meshes, …