3d-texture-toolkit

3D Texture Toolkit MCP

GLB ファイルから埋め込み PBR テクスチャ画像を抽出するローカル MCP サーバーです。 extract_pbr_maps というツールを 1 つ公開します。

必要条件

• Node.js 20 以降
• ローカル stdio サーバーに対応した MCP クライアント

インストールと実行

このパッケージが npm に公開されたら、npx を使って MCP クライアントにインストールします。

npx -y 3d-texture-toolkit-mcp

サーバーは MCP クライアントから指定された GLB パスを読み取り、抽出した画像をディスクに書き込みます。ベースカラー画像と法線画像は、元の PNG、JPEG、または WebP のバイト列をそのまま保持します。glTF のメタリック・ラフネス画像は、グレースケール PNG ファイルに分割されます。ラフネスは緑チャンネルから、メタリックは青チャンネルから取得されます。対応する glTF マテリアル係数は、これら 2 つのマップに適用されます。

クライアント設定

mcpServers オブジェクトを受け付ける MCP クライアントの設定例：

{
  "mcpServers": {
    "3d-texture-toolkit": {
      "command": "npx",
      "args": ["-y", "3d-texture-toolkit-mcp"]
    }
  }
}

npm でリリースする前にローカルで開発する場合は、パッケージをビルドし、絶対パス dist/index.js を引数として node をクライアントに指定します。

ツールの入力

• glb_path（必須）：ローカルの GLB 2.0 ファイルへのパス。
• output_dir（任意）：出力フォルダー。デフォルトでは、GLB と同じ場所に <glb-name>-textures という名前のフォルダーが作成されます。
• overwrite（任意、デフォルトは false）：同じ出力名のファイルを置き換えます。デフォルトでは既存のファイルをスキップします。

出力名には、マテリアル番号、サニタイズされたマテリアル名、およびマップの種類が含まれます。このツールは、書き込んだファイル、スキップしたマップ、警告を報告します。

プライバシー

サーバーはお使いのコンピューター上でファイルを処理します。ネットワークリクエストは行わず、モデルやテクスチャのデータをアップロードすることもありません。GLB と出力ディレクトリーには、MCP サーバーを実行するマシンからアクセスできる必要があります。

制限事項

• バッファービューに埋め込まれた画像、または対応する PNG、JPEG、WebP のデータ URI を含む GLB 2.0 に対応しています。
• 外部画像 URL と外部バッファーファイルは読み込みません。
• KTX2 や Basis Universal など、その他の画像形式はデコードしません。
• テクスチャ変換、代替 UV セット、オクルージョンマップ、エミッシブマップ、およびマテリアルの解釈を変更する拡張機能は適用されません。
• パックされたメタリック・ラフネス画像は、グレースケール PNG に変換されます。ベースカラー画像と法線画像は、再圧縮せずにコピーされます。
• 安全上の制限により、512 MiB を超えるファイル、およびデコード後に 1 億ピクセルを超える画像は拒否されます。

公開状況

パッケージ名は 3d-texture-toolkit-mcp です。このリポジトリーには、公式 MCP Registry 用の server.json メタデータが含まれています。パッケージは MIT License を使用しています。Registry に申請した後、サーバーがそこで公開されていることを確認してください。メタデータがあるだけでは、Registry への掲載を確認できません。