mcp-vfx-parsers

MCP-Server für das Parsen von VFX-Dateiformaten. Analysieren und generieren Sie Nuke .nk-, MaterialX .mtlx- und USD ASCII .usda-Dateien – alles über das MCP-stdio-Protokoll. Round-Trip-stabil.

Tools

Alle Tools sind schreibgeschützt – sie transformieren Text und greifen niemals auf das Dateisystem zu.

Installation

npx -y mcp-vfx-parsers

Verwendung mit Claude Code

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

Verwendung mit Claude Desktop

Fügen Sie dies zu claude_desktop_config.json hinzu:

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

Unterstützte Formate

Nuke .nk

Foundry Nuke Compositing-Skripte. Parsen des stapelbasierten Knotengraph-Formats, einschließlich:

• Knotentypen, Eigenschaften, Positionen

• Eingangsverkabelung über set/push-Stack-Direktiven

• Root-Einstellungen

• TCL-Ausdrücke und UserKnob-Blöcke (als opaker Text beibehalten)

MaterialX .mtlx

MaterialX Shading-Netzwerkdefinitionen. Parsen des XML-basierten Formats, einschließlich:

• Knotengraphen mit typisierten Eingängen/Ausgängen

• Materialzuweisungen

• nodename-Verbindungsreferenzen (DAG-Kantenextraktion)

• Attributerhaltung (Anführungszeichen-Stil, Reihenfolge)

• Kommentare und XML-Prolog

USD ASCII .usda

Pixar Universal Scene Description (ASCII-Layer-Format). Volle Grammatikunterstützung:

• Prim-Hierarchie (def, over, class)

• Typisierte Attribute mit uniform/custom-Modifikatoren

• .connect-Verbindungen (UsdShade-Knotengraphen)

• .timeSamples-Animationsdaten

• Beziehungen (einzelne + Array-Ziele)

• VariantSets mit verschachtelten Varianten-Bodys

• Kompositions-Arcs: Referenzen, Payloads, Inherits, Specializes

• Layer- und Prim-Metadaten

Round-Trip-Garantie

Alle Parser wahren eine strikte Round-Trip-Invariante:

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

Nuke und MaterialX erzeugen byte-identische Ausgaben. USDA erzeugt semantisch identische Ausgaben in kanonischer Pretty-Print-Form (Kommentare werden entfernt – dokumentierte Einschränkung).

Entwicklung

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

Lizenz

MIT