mcp-vfx-parsers

Servidor MCP para el análisis de formatos de archivo de VFX. Analiza y genera archivos Nuke .nk, MaterialX .mtlx y USD ASCII .usda, todo a través del protocolo stdio de MCP. Estable en procesos de ida y vuelta.

Herramientas

Todas las herramientas son de solo lectura: transforman texto, nunca tocan el sistema de archivos.

Instalación

npx -y mcp-vfx-parsers

Uso con Claude Code

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

Uso con Claude Desktop

Añadir a claude_desktop_config.json:

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

Formatos soportados

Nuke .nk

Scripts de composición de Foundry Nuke. Analiza el formato de grafo de nodos basado en pila, incluyendo:

• Tipos de nodo, propiedades, posiciones

• Cableado de entrada mediante directivas de pila set/push

• Configuración raíz

• Expresiones TCL y bloques UserKnob (preservados como texto opaco)

MaterialX .mtlx

Definiciones de red de sombreado MaterialX. Analiza el formato basado en XML, incluyendo:

• Grafos de nodos con entradas/salidas tipadas

• Asignaciones de materiales

• Referencias de conexión nodename (extracción de aristas DAG)

• Preservación de atributos (estilo de comillas, orden)

• Comentarios y prólogo XML

USD ASCII .usda

Universal Scene Description de Pixar (formato de capa ASCII). Soporte gramatical completo:

• Jerarquía de Prim (def, over, class)

• Atributos tipados con modificadores uniform/custom

• Conexiones .connect (grafos de nodos UsdShade)

• Datos de animación .timeSamples

• Relaciones (objetivos simples + matriz)

• VariantSets con cuerpos de variante anidados

• Arcos de composición: referencias, payloads, herencias, especializaciones

• Metadatos de capa y prim

Garantía de ida y vuelta

Todos los analizadores mantienen un invariante estricto de ida y vuelta:

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

Nuke y MaterialX producen una salida idéntica byte a byte. USDA produce una salida semánticamente idéntica en forma canónica de pretty-print (comentarios eliminados: limitación documentada).

Desarrollo

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

Licencia

MIT