USD场景交互工具

美元mcp

模型上下文协议（MCP）服务器，用于使用适用于LLM编排的干净、单动作工具与Pixar USD（通用场景描述）文件进行交互。

特性

• 阶段管理：打开/关闭、列表、摘要（有状态）和无状态文件助手。
• 文件检查：summarizeFile、listPrimeFile、primInfoFile、getAttrFile。
• 属性写入：setAttrFile和通过setAttrsFile设置的批处理（别名displayColor→primvars：显示颜色，强制值[r，g，b]→[[r，g，b]]）。
• Prim编写：创建PrimFile，删除PrimFile。
• 转换：getXformFile，setXformFile（CommonAPI操作；strips TypeTransform；智能父/子缩放；gprim大小处理）。
• 组合：组合ReferencedAssembly（一次性），添加ReferencesBatchInFile，设置DefaultPrimFile。
• 变量：列出变量文件，设置变量文件。
• 材料：listMaterialsFile、bindMaterialFile、unbindMaterialFile、getMaterialBindingFile。
• 相机：列出CamerasFile，获取CameraFile，设置CameraFile。
• Bounds：获取BoundsFile（世界AABB，有回退）。
• 导出：导出UsdFile（展开，skipIfExists），导出UsdzFile。
• 人机工程学：相机外壳工具别名；参数规范化（扁平JSON，容错键）；createStage处于打开或创建状态，默认为upAxis Z。

文件和指南

• 文档索引： 文档索引
• 安装： 安装
• 用法和快速入门： 使用/快速启动
• 工具合同（0级）： 0级工具
• 架构决策： 不良反应
• MCP+握带设置： 带握带的MCP
• 握带的NL提示示例： 握带提示
  • 包括通过composeReferencedAssembly和批引用帮助程序的新组合流。
• 与检验员进行本地测试： MCP检查员

例子

• 看 示例/ 包括：
  • minimal_read.py
  • create_stage.py

许可证

• 阿帕奇-2.0。看 LICENSE.

状态

• 积极发展。请参阅上面的功能以了解现在可用的功能。

快速安装

• 创建venv，安装软件包，然后安装USD车轮（如果可用）：
  • python -m venv .venv && source .venv/bin/activate
  • pip install -e .
  • pip install "usd-core==25.11"
  • python -c "import pxr, usd_mcp; print('ok')"