mcp-vfx-parsers

用于 VFX 文件格式解析的 MCP 服务器。通过 MCP stdio 协议解析和生成 Nuke .nk、MaterialX .mtlx 和 USD ASCII .usda 文件，并保持往返稳定性。

工具

所有工具均为只读 —— 它们仅转换文本，绝不触碰文件系统。

安装

npx -y mcp-vfx-parsers

与 Claude Code 配合使用

{
  "mcpServers": {
    "vfx-parsers": {
      "command": "npx",
      "args": ["-y", "mcp-vfx-parsers"]
    }
  }
}

与 Claude Desktop 配合使用

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "vfx-parsers": {
      "command": "npx",
      "args": ["-y", "mcp-vfx-parsers"]
    }
  }
}

支持的格式

Nuke .nk

Foundry Nuke 合成脚本。解析基于堆栈的节点图格式，包括：

• 节点类型、属性、位置

• 通过 set/push 堆栈指令进行的输入连接

• 根设置

• TCL 表达式和 UserKnob 块（作为不透明文本保留）

MaterialX .mtlx

MaterialX 着色网络定义。解析基于 XML 的格式，包括：

• 带有类型化输入/输出的节点图

• 材质分配

• nodename 连接引用（DAG 边提取）

• 属性保留（引号样式、顺序）

• 注释和 XML 序言

USD ASCII .usda

Pixar 通用场景描述（ASCII 层格式）。完整语法支持：

• Prim 层级（def、over、class）

• 带有 uniform/custom 修饰符的类型化属性

• .connect 连接（UsdShade 节点图）

• .timeSamples 动画数据

• 关系（单目标 + 数组目标）

• 带有嵌套变体主体的 VariantSets

• 合成弧：引用 (references)、载荷 (payloads)、继承 (inherits)、特化 (specializes)

• 层和 Prim 元数据

往返保证

所有解析器都保持严格的往返不变性：

parse(generate(parse(input))) === parse(input)

Nuke 和 MaterialX 生成字节完全相同的输出。USDA 生成语义完全相同的规范化格式输出（注释会被移除 —— 这是已知的局限性）。

开发

git clone https://github.com/MABAAM/mcp-vfx-parsers.git
cd mcp-vfx-parsers
npm install
npm test
node src/server.mjs

许可证

MIT