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 Universal Scene Description (ASCII 레이어 형식)입니다. 전체 문법을 지원합니다:

• 프림 계층 구조 (def, over, class)

• uniform/custom 수정자가 있는 유형별 속성

• .connect 연결 (UsdShade 노드 그래프)

• .timeSamples 애니메이션 데이터

• 관계 (단일 및 배열 대상)

• 중첩된 변형 본문이 있는 VariantSets

• 구성 아크: 참조, 페이로드, 상속, 특수화

• 레이어 및 프림 메타데이터

왕복 보장

모든 파서는 엄격한 왕복 불변성을 유지합니다:

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

Nuke와 MaterialX는 바이트 단위로 동일한 출력을 생성합니다. USDA는 표준 예쁜 출력(pretty-print) 형식으로 의미론적으로 동일한 출력을 생성합니다 (주석은 제거됨 — 문서화된 제한 사항).

개발

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

라이선스

MIT