
daslabhq/openusd-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
An MCP server that lets AI assistants read, inspect, and manipulate [OpenUSD](https://openusd.org) scenes.
Обзор
An MCP server that lets AI assistants read, inspect, and manipulate OpenUSD scenes. — interactive 3D viewer with variant switching 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. 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."* The server communicates over stdin/stdout using the MCP protocol. The repo includes two example scenes that exercise all 8 tools.
README
Показан фрагмент оригинального README. Открыть оригинал.
openusd-mcp
An MCP server that lets AI assistants read, inspect, and manipulate OpenUSD scenes.
Live Demo — 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:
{
"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
openusd-mcp --stdio
The server communicates over stdin/stdout using the MCP protocol.
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, real-world dimensions.
You: What's in examples/desk_setup.usda?
Claude: A desk scene with 25 prims, 10 meshes, 5 materials:
/Desk (Xform)
/Desk/Table/Top (Mesh) — Wood, 120×60×3 cm
/Desk/Table/Leg1..4 (Mesh) — Metal
/Desk/Monitor/Screen (Mesh) — dark glossy
/Desk/Monitor/Stand (Mesh) — Metal
/Desk/Monitor/Base (Mesh) — Metal
/Desk/Keyboard (Mesh) — DarkPlastic
/Desk/Mug/Body (Mesh) — Ceramic
Bounds: 1200 × 835 × 1250 mm
You: Export the tabletop as STL
Claude: Exported /Desk/Table/Top to tabletop.stl (12 triangles, 684 bytes)
Product configurator — variant switching
A device with 3 variant sets: size (small, medium, large), color (midnight, silver, gold, red), and finish (matte, satin, glossy).
You: What configuration options does examples/product_configurator.usda have?
Claude: The product at /Product has 3 variant sets:
size: small | medium* | large
color: midnight* | silver | gold | red
Установка
This server does not publish a one-line install command.
Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →Конфигурация
{
"mcpServers": {
"openusd": {
"command": "openusd-mcp",
"args": []
}
}
}