mcp-vfx-parsers

MCP-сервер для парсинга форматов файлов VFX. Парсинг и генерация файлов Nuke .nk, MaterialX .mtlx и USD ASCII .usda — всё через протокол MCP stdio. Стабильность при обратном преобразовании.

Инструменты

Все инструменты работают только для чтения — они преобразуют текст и никогда не обращаются к файловой системе.

Установка

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 Universal Scene Description (формат слоя ASCII). Полная поддержка грамматики:

• Иерархия примитивов (def, over, class)

• Типизированные атрибуты с модификаторами uniform/custom

• Соединения .connect (графы узлов UsdShade)

• Данные анимации .timeSamples

• Отношения (одиночные и массивы целей)

• VariantSets с вложенными телами вариантов

• Дуги композиции: ссылки (references), payloads, inherits, specializes

• Метаданные слоев и примитивов

Гарантия обратного преобразования

Все парсеры поддерживают строгий инвариант обратного преобразования:

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