openusd mcp
允许AI助手读取、检查和操作的MCP服务器 开放美元 场景。
现场演示 --具有变体切换功能的交互式3D查看器
pip install openusd-mcp它的作用
将此MCP服务器连接到Claude、ChatGPT、Cursor或任何兼容MCP的客户端。然后，您的AI助手可以直接与 .usda, .usdc，以及 .usdz 文件——检查场景图、查询属性、导出网格和切换变量。
工具
| 工具 | 说明 |
|---|---|
usd_inspect | 阅读场景图——列出所有首字母、类型、层次 |
usd_get_prim | 获取特定prim的详细属性、特性和元数据 |
usd_get_materials | 列出所有材质及其着色器参数 |
usd_get_transforms | 为prims获取世界空间变换 |
usd_list_variants | 列出所有变体集及其选项 |
usd_set_variant | 切换变体选择 |
usd_export_mesh | 将网格prim导出为STL或OBJ |
usd_scene_stats | 获取场景统计信息——原始计数、网格计数、材质计数、边界框 |
快速开始
使用克劳德桌面
添加到您的 claude_desktop_config.json:
{
"mcpServers": {
"openusd": {
"command": "openusd-mcp",
"args": []
}
}
}然后尝试使用包含的示例场景：
*“检查示例/desk_setup.usda的场景图，并描述桌面上的内容。”*
*“examples/product_configurator.usda中的产品有哪些颜色选项？将其切换为金色。”*
使用任何MCP客户端
openusd-mcp --stdio服务器通过stdin/stdout使用 MCP协议.
例子
该仓库包括两个示例场景，用于练习所有8个工具。
桌面设置——现场检查
带桌子、显示器、键盘和杯子的桌子。5种PBR材料（木材、金属、屏幕、陶瓷、深色塑料），10个网眼，真实世界的尺寸。
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)产品配置器——变量切换
具有3个变体组的设备： 尺寸 （小、中、大）， 颜色 （午夜、银色、金色、红色），以及 完成 （哑光、缎面、光泽）。
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
finish: matte | satin* | glossy
(* = currently selected)
You: Switch to gold, large, glossy
Claude: Done. Updated /Product:
size: large (1.4× scale)
color: gold — diffuseColor: (0.83, 0.69, 0.22), metallic: 0.9
finish: glossy — roughness: 0.1需求
- Python 3.9+
usd-core（皮克斯的美元Python绑定）
pip install usd-core运作原理
服务器使用Pixar的官方 pxr Python绑定（与NVIDIA Omniverse、Apple的Reality Composer和每个主要的VFX管道使用的库相同）用于读取和操作USD阶段。它将这些功能作为MCP工具公开，任何AI助手都可以调用。
OpenUSD是 行业标准 用于描述3D场景，由皮克斯、苹果、英伟达、Adobe和Autodesk支持。截至2025年12月，开放美元联盟已批准 核心规范1.0.
作者
许可证
麻省理工学院