mcp-vfx-parsers
MCP server for VFX file format parsing. Parse and generate Nuke .nk, MaterialX .mtlx, and USD ASCII .usda files — all via the MCP stdio protocol. Round-trip stable.
Tools
| Tool | Description |
|---|---|
parse_nuke | Parse .nk script → JSON AST (nodes, properties, DAG wiring) |
parse_mtlx | Parse .mtlx XML → JSON AST (node graphs, inputs, materials) |
parse_usda | Parse .usda text → JSON AST (prims, attributes, variants, connections) |
generate_nuke | JSON AST → .nk script (round-trip stable) |
generate_mtlx | JSON AST → .mtlx XML (round-trip stable) |
generate_usda | JSON AST → .usda text (semantic round-trip) |
All tools are read-only — they transform text, never touch the filesystem.
Install
npx -y mcp-vfx-parsers
Usage with Claude Code
{
"mcpServers": {
"vfx-parsers": {
"command": "npx",
"args": ["-y", "mcp-vfx-parsers"]
}
}
}
Usage with Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"vfx-parsers": {
"command": "npx",
"args": ["-y", "mcp-vfx-parsers"]
}
}
}
Supported Formats
Nuke .nk
Foundry Nuke compositing scripts. Parses the stack-based node graph format including:
- Node types, properties, positions
- Input wiring via set/push stack directives
- Root settings
- TCL expressions and UserKnob blocks (preserved as opaque text)
MaterialX .mtlx
MaterialX shading network definitions. Parses the XML-based format including:
- Node graphs with typed inputs/outputs
- Material assignments
nodenameconnection references (DAG edge extraction)- Attribute preservation (quote style, order)
- Comments and XML prolog
USD ASCII .usda
Pixar Universal Scene Description (ASCII layer format). Full grammar support:
- Prim hierarchy (
def,over,class) - Typed attributes with
uniform/custommodifiers .connectconnections (UsdShade node graphs).timeSamplesanimation data- Relationships (single + array targets)
- VariantSets with nested variant bodies
- Composition arcs: references, payloads, inherits, specializes
- Layer and prim metadata
Round-Trip Guarantee
All parsers maintain a strict round-trip invariant:
parse(generate(parse(input))) === parse(input)
Nuke and MaterialX produce byte-identical output. USDA produces semantically identical output in canonical pretty-print form (comments stripped — documented limitation).
Development
git clone https://github.com/MABAAM/mcp-vfx-parsers.git
cd mcp-vfx-parsers
npm install
npm test
node src/server.mjs
License
MIT