mcp-vfx-parsers

VFXファイル形式解析用のMCPサーバー。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

• コンポジションアーク：参照、ペイロード、継承、特殊化

• レイヤーおよびプリムのメタデータ

ラウンドトリップ保証

すべてのパーサーは厳密なラウンドトリップ不変条件を維持します：

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