gltf-mcp 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 EliXR Games
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,82 @@
+# gltf-mcp
+
+An [MCP](https://modelcontextprotocol.io/) server that lets AI assistants inspect and render glTF/GLB 3D model files.
+
+## Features
+
+- **Inspect models** - Get triangle counts, bounding boxes, materials, animations, scene hierarchy, and potential issues
+- **Render to PNG** - PBR rendering with studio lighting, wireframe, and normal visualization modes
+- **Texture overrides** - Swap material textures at render time without modifying the model
+- **Full format support** - glTF 2.0, GLB, external textures, Draco, Meshopt, KTX2/Basis
+
+## Quick Start
+
+### Claude Desktop
+
+Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "gltf-mcp": {
+      "command": "npx",
+      "args": ["gltf-mcp"]
+    }
+  }
+}
+```
+
+### Claude Code
+
+Create `.mcp.json` in your project root:
+
+```json
+{
+  "mcpServers": {
+    "gltf-mcp": {
+      "command": "npx",
+      "args": ["gltf-mcp"]
+    }
+  }
+}
+```
+
+## Tools
+
+### `get_gltf_info`
+
+Inspect a glTF/GLB file and return structured metadata.
+
+```
+file_path: "/path/to/model.glb"
+```
+
+Returns: file size, triangle/vertex counts, bounding box, materials, animations, skins, scene hierarchy, compression state, and potential issues.
+
+### `render_gltf`
+
+Render a glTF/GLB file to a PNG image.
+
+```
+file_path: "/path/to/model.glb"
+mode: "default" | "wireframe" | "normals"
+yaw: 0          # camera rotation in degrees
+pitch: 0
+roll: 0
+resolution: 800 # output size in pixels
+```
+
+Returns: PNG image with metadata (normalization info, warnings).
+
+## Requirements
+
+- Node.js 18+
+- Puppeteer downloads Chromium (~200MB) on first install
+
+## Documentation
+
+Full documentation: [elixr-games.github.io/gltf-mcp](https://elixr-games.github.io/gltf-mcp/)
+
+## License
+
+[MIT](LICENSE)

package/build/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/build/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/build/index.js

@@ -0,0 +1,71 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { getGltfInfo } from "./tools/get-gltf-info.js";
+import { renderGltf } from "./tools/render-gltf.js";
+const server = new McpServer({
+    name: "gltf-mcp",
+    version: "0.2.0",
+});
+server.tool("get_gltf_info", "Inspect a glTF/GLB file and return structured metadata including a summary (triangle/vertex counts, bounding box, draw call estimate, texture memory, compression state, potential issues) plus detailed sections for materials, animations, skins, and scene hierarchy with transforms.", {
+    file_path: z.string().describe("Path to a .gltf or .glb file"),
+}, async ({ file_path }) => {
+    return getGltfInfo(file_path);
+});
+server.tool("render_gltf", "Render a glTF/GLB file to a PNG image. Supports PBR rendering with neutral studio lighting (RoomEnvironment IBL), wireframe mode, and normal visualization. Full glTF extension support including KTX2 textures, Draco mesh compression, and Meshopt. The model is normalized to unit size. Returns JSON metadata and a base64-encoded PNG.", {
+    file_path: z.string().describe("Path to a .gltf or .glb file"),
+    yaw: z
+        .number()
+        .optional()
+        .default(0)
+        .describe("Camera yaw rotation in degrees (around Y axis)"),
+    pitch: z
+        .number()
+        .optional()
+        .default(0)
+        .describe("Camera pitch rotation in degrees (around X axis)"),
+    roll: z
+        .number()
+        .optional()
+        .default(0)
+        .describe("Camera roll rotation in degrees (around Z axis)"),
+    resolution: z
+        .number()
+        .optional()
+        .default(800)
+        .describe("Output image resolution in pixels (square)"),
+    mode: z
+        .enum(["default", "wireframe", "normals"])
+        .optional()
+        .default("default")
+        .describe("Render mode: 'default' (PBR with neutral studio lighting), 'wireframe' (mesh topology), 'normals' (surface orientation as RGB)"),
+    texture_overrides: z
+        .object({
+        baseColor: z.string().optional().describe("Path to base color / albedo texture image"),
+        normal: z.string().optional().describe("Path to normal map image"),
+        metallicRoughness: z.string().optional().describe("Path to metallic-roughness map image"),
+        occlusion: z.string().optional().describe("Path to ambient occlusion map image"),
+        emissive: z.string().optional().describe("Path to emissive map image"),
+    })
+        .optional()
+        .describe("Override material textures by slot. Applied to all materials in the model."),
+}, async ({ file_path, yaw, pitch, roll, resolution, mode, texture_overrides }) => {
+    return renderGltf(file_path, {
+        yaw,
+        pitch,
+        roll,
+        resolution,
+        mode,
+        textureOverrides: texture_overrides,
+    });
+});
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/renderer/renderer.html

@@ -0,0 +1,235 @@
+<!DOCTYPE html>
+<html>
+<head>
+<meta charset="utf-8">
+<style>html, body { margin: 0; padding: 0; overflow: hidden; background: transparent; }</style>
+<script type="importmap">
+{
+  "imports": {
+    "three": "/node_modules/three/build/three.module.js",
+    "three/addons/": "/node_modules/three/examples/jsm/"
+  }
+}
+</script>
+</head>
+<body>
+<script type="module">
+import * as THREE from 'three';
+import { RoomEnvironment } from 'three/addons/environments/RoomEnvironment.js';
+import { MeshoptDecoder } from 'three/addons/libs/meshopt_decoder.module.js';
+import { DRACOLoader } from 'three/addons/loaders/DRACOLoader.js';
+import { GLTFLoader } from 'three/addons/loaders/GLTFLoader.js';
+import { KTX2Loader } from 'three/addons/loaders/KTX2Loader.js';
+
+// Initialize renderer
+const renderer = new THREE.WebGLRenderer({
+  alpha: true,
+  antialias: true,
+  preserveDrawingBuffer: true,
+});
+renderer.setPixelRatio(1);
+renderer.toneMapping = THREE.ACESFilmicToneMapping;
+renderer.toneMappingExposure = 1.0;
+document.body.appendChild(renderer.domElement);
+
+// Create neutral environment map (PBR IBL)
+const pmremGenerator = new THREE.PMREMGenerator(renderer);
+const neutralEnvMap = pmremGenerator.fromScene(new RoomEnvironment()).texture;
+pmremGenerator.dispose();
+
+// Configure loaders
+const dracoLoader = new DRACOLoader();
+dracoLoader.setDecoderPath('/node_modules/three/examples/jsm/libs/draco/gltf/');
+
+const ktx2Loader = new KTX2Loader();
+ktx2Loader.setTranscoderPath('/node_modules/three/examples/jsm/libs/basis/');
+ktx2Loader.detectSupport(renderer);
+
+const loader = new GLTFLoader();
+loader.setDRACOLoader(dracoLoader);
+loader.setKTX2Loader(ktx2Loader);
+loader.setMeshoptDecoder(MeshoptDecoder);
+
+window.renderModel = async (options) => {
+  const { glbUrl, width, height, yaw, pitch, roll, mode, textureOverrideUrls } = options;
+
+  // Resize
+  renderer.setSize(width, height);
+
+  // Create scene
+  const scene = new THREE.Scene();
+  scene.background = null;
+  scene.environment = neutralEnvMap;
+
+  // Track warnings from texture load failures
+  const warnings = [];
+  const origWarn = console.warn;
+  const origError = console.error;
+  const warnHandler = (...args) => {
+    const msg = args.map(a => String(a)).join(' ');
+    if (msg.includes('texture') || msg.includes('Texture') || msg.includes('image') || msg.includes('404') || msg.includes('Failed to load')) {
+      warnings.push(msg);
+    }
+    origWarn.apply(console, args);
+  };
+  const errorHandler = (...args) => {
+    const msg = args.map(a => String(a)).join(' ');
+    if (msg.includes('texture') || msg.includes('Texture') || msg.includes('image') || msg.includes('404') || msg.includes('Failed to load')) {
+      warnings.push(msg);
+    }
+    origError.apply(console, args);
+  };
+  console.warn = warnHandler;
+  console.error = errorHandler;
+
+  // Load GLB/glTF
+  let gltf;
+  try {
+    gltf = await loader.loadAsync(glbUrl);
+  } finally {
+    console.warn = origWarn;
+    console.error = origError;
+  }
+  const model = gltf.scene;
+
+  // Apply texture overrides (before render mode, since normals mode replaces materials)
+  if (textureOverrideUrls && Object.keys(textureOverrideUrls).length > 0) {
+    const texLoader = new THREE.TextureLoader();
+    const slotMap = {
+      baseColor: 'map',
+      normal: 'normalMap',
+      metallicRoughness: ['metalnessMap', 'roughnessMap'],
+      occlusion: 'aoMap',
+      emissive: 'emissiveMap',
+    };
+    const srgbSlots = new Set(['baseColor', 'emissive']);
+
+    for (const [slot, url] of Object.entries(textureOverrideUrls)) {
+      try {
+        const tex = await texLoader.loadAsync(url);
+        tex.flipY = false;
+        tex.colorSpace = srgbSlots.has(slot) ? THREE.SRGBColorSpace : THREE.LinearSRGBColorSpace;
+
+        model.traverse((node) => {
+          if (!node.isMesh || !node.material) return;
+          const mats = Array.isArray(node.material) ? node.material : [node.material];
+          mats.forEach((mat) => {
+            const matSlots = slotMap[slot];
+            if (Array.isArray(matSlots)) {
+              matSlots.forEach(s => { mat[s] = tex; });
+            } else if (matSlots) {
+              mat[matSlots] = tex;
+            }
+            if (slot === 'emissive') {
+              mat.emissiveIntensity = 1.0;
+              mat.emissive = new THREE.Color(1, 1, 1);
+            }
+            mat.needsUpdate = true;
+          });
+        });
+      } catch (err) {
+        warnings.push(`Failed to load texture override for '${slot}': ${err.message || err}`);
+      }
+    }
+  }
+
+  // Apply render mode
+  if (mode === 'wireframe') {
+    model.traverse((node) => {
+      if (node.isMesh && node.material) {
+        const mats = Array.isArray(node.material) ? node.material : [node.material];
+        mats.forEach((mat) => { mat.wireframe = true; });
+      }
+    });
+  } else if (mode === 'normals') {
+    model.traverse((node) => {
+      if (node.isMesh && node.material) {
+        const origMat = Array.isArray(node.material) ? node.material[0] : node.material;
+        node.material = new THREE.MeshNormalMaterial({ side: origMat.side });
+      }
+    });
+  }
+  // 'default' mode: keep PBR materials as-is
+
+  // Normalize model to unit cube centered at origin
+  model.updateMatrixWorld(true);
+  const box = new THREE.Box3().setFromObject(model);
+  const size = box.getSize(new THREE.Vector3());
+  const center = box.getCenter(new THREE.Vector3());
+  const maxDim = Math.max(size.x, size.y, size.z);
+  const scaleFactor = maxDim > 0 ? 1.0 / maxDim : 1.0;
+
+  const normalization = {
+    scaleFactor,
+    originalDimensions: {
+      x: parseFloat(size.x.toFixed(6)),
+      y: parseFloat(size.y.toFixed(6)),
+      z: parseFloat(size.z.toFixed(6)),
+    },
+    originalCenter: {
+      x: parseFloat(center.x.toFixed(6)),
+      y: parseFloat(center.y.toFixed(6)),
+      z: parseFloat(center.z.toFixed(6)),
+    },
+  };
+
+  model.scale.multiplyScalar(scaleFactor);
+  model.position.copy(center).multiplyScalar(-scaleFactor);
+  model.updateMatrixWorld(true);
+
+  scene.add(model);
+
+  // Camera setup
+  const camera = new THREE.PerspectiveCamera(60, 1, 0.01, 100);
+  const cameraDist = 1.5;
+
+  const yawRad = (yaw * Math.PI) / 180;
+  const pitchRad = (pitch * Math.PI) / 180;
+  const baseTheta = Math.PI / 4;
+  const basePhi = Math.PI / 2 - 0.3;
+
+  const theta = baseTheta + yawRad;
+  const phi = Math.max(0.01, Math.min(Math.PI - 0.01, basePhi - pitchRad));
+
+  camera.position.set(
+    cameraDist * Math.sin(phi) * Math.sin(theta),
+    cameraDist * Math.cos(phi),
+    cameraDist * Math.sin(phi) * Math.cos(theta)
+  );
+  camera.lookAt(0, 0, 0);
+
+  if (roll !== 0) {
+    const rollRad = (roll * Math.PI) / 180;
+    camera.rotateZ(rollRad);
+  }
+
+  // Render
+  renderer.render(scene, camera);
+
+  // Capture as data URL
+  const dataUrl = renderer.domElement.toDataURL('image/png');
+
+  // Cleanup - dispose scene objects
+  scene.remove(model);
+  model.traverse((node) => {
+    if (node.geometry) node.geometry.dispose();
+    if (node.material) {
+      const materials = Array.isArray(node.material) ? node.material : [node.material];
+      materials.forEach((mat) => {
+        for (const key in mat) {
+          if (mat[key]?.isTexture && mat[key] !== neutralEnvMap) {
+            mat[key].dispose();
+          }
+        }
+        mat.dispose();
+      });
+    }
+  });
+
+  return { normalization, dataUrl, warnings };
+};
+
+window.rendererReady = true;
+</script>
+</body>
+</html>

package/build/tools/get-gltf-info.d.ts

@@ -0,0 +1,14 @@
+export declare function getGltfInfo(filePath: string): Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+//# sourceMappingURL=get-gltf-info.d.ts.map

package/build/tools/get-gltf-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gltf-info.d.ts","sourceRoot":"","sources":["../../src/tools/get-gltf-info.ts"],"names":[],"mappings":"AAqBA,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM;;;;;;;;;;;;GAyNjD"}

package/build/tools/get-gltf-info.js

@@ -0,0 +1,205 @@
+import fs from "node:fs";
+import { getBounds, inspect } from "@gltf-transform/functions";
+import { createIO } from "../utils/gltf-io.js";
+import { validateFilePath } from "../utils/path-security.js";
+export async function getGltfInfo(filePath) {
+    try {
+        const resolvedPath = validateFilePath(filePath);
+        const io = await createIO();
+        const doc = await io.read(resolvedPath);
+        const root = doc.getRoot();
+        // Run inspect for structured report
+        const report = inspect(doc);
+        // File size
+        const fileSize = fs.statSync(resolvedPath).size;
+        // Asset info
+        const asset = root.getAsset();
+        const generator = asset.generator || "unknown";
+        const gltfVersion = asset.version || "2.0";
+        // Get bounding box from default scene
+        const scene = root.listScenes()[0];
+        let boundingBox = null;
+        if (scene) {
+            const bounds = getBounds(scene);
+            boundingBox = {
+                min: bounds.min,
+                max: bounds.max,
+                dimensions: {
+                    x: bounds.max[0] - bounds.min[0],
+                    y: bounds.max[1] - bounds.min[1],
+                    z: bounds.max[2] - bounds.min[2],
+                },
+                center: {
+                    x: (bounds.min[0] + bounds.max[0]) / 2,
+                    y: (bounds.min[1] + bounds.max[1]) / 2,
+                    z: (bounds.min[2] + bounds.max[2]) / 2,
+                },
+            };
+        }
+        // Compute aggregate counts
+        let totalVertices = 0;
+        let totalTriangles = 0;
+        let drawCallEstimate = 0;
+        for (const mesh of report.meshes.properties) {
+            totalVertices += mesh.vertices;
+            totalTriangles += mesh.glPrimitives;
+            drawCallEstimate += mesh.meshPrimitives;
+        }
+        const meshCount = report.meshes.properties.length;
+        const materialCount = report.materials.properties.length;
+        const textureCount = report.textures.properties.length;
+        const animationCount = report.animations.properties.length;
+        const skinCount = root.listSkins().length;
+        // Total texture memory (from inspect gpuSize)
+        let totalTextureMemoryBytes = 0;
+        for (const tex of report.textures.properties) {
+            const texExt = tex;
+            if (texExt.gpuSize) {
+                totalTextureMemoryBytes += texExt.gpuSize;
+            }
+        }
+        const totalTextureMemoryMB = parseFloat((totalTextureMemoryBytes / (1024 * 1024)).toFixed(2));
+        // Extensions
+        const extensionsUsed = root.listExtensionsUsed().map((ext) => ext.extensionName);
+        const extensionsRequired = root.listExtensionsRequired().map((ext) => ext.extensionName);
+        // Compression state
+        const compressionState = {
+            draco: extensionsUsed.includes("KHR_draco_mesh_compression"),
+            meshopt: extensionsUsed.includes("EXT_meshopt_compression"),
+            ktx2Basis: extensionsUsed.includes("KHR_texture_basisu"),
+        };
+        // Potential issues
+        const potentialIssues = [];
+        if (totalTriangles > 500000) {
+            potentialIssues.push(`High triangle count (${totalTriangles.toLocaleString()})`);
+        }
+        if (drawCallEstimate > 100) {
+            potentialIssues.push(`High draw call count (~${drawCallEstimate})`);
+        }
+        for (const tex of report.textures.properties) {
+            const texExt = tex;
+            const size = texExt.resolution;
+            if (size) {
+                const match = String(size).match(/(\d+)x(\d+)/);
+                if (match) {
+                    const maxRes = Math.max(parseInt(match[1], 10), parseInt(match[2], 10));
+                    if (maxRes > 4096) {
+                        potentialIssues.push(`Texture "${tex.name || "(unnamed)"}" exceeds 4K (${size})`);
+                    }
+                }
+            }
+        }
+        if (!compressionState.draco && !compressionState.meshopt) {
+            potentialIssues.push("No mesh compression (Draco/meshopt could reduce size)");
+        }
+        if (!compressionState.ktx2Basis) {
+            potentialIssues.push("No texture compression (KTX2/Basis could reduce GPU memory)");
+        }
+        // Summary
+        const summary = {
+            fileSize,
+            generator,
+            gltfVersion,
+            totalTriangles,
+            totalVertices,
+            meshCount,
+            materialCount,
+            textureCount,
+            animationCount,
+            skinCount,
+            drawCallEstimate,
+            totalTextureMemoryMB,
+            boundingBox,
+            compressionState,
+            potentialIssues,
+        };
+        // Material details
+        const materials = root.listMaterials().map((mat) => {
+            const baseColorTex = mat.getBaseColorTexture();
+            const normalTex = mat.getNormalTexture();
+            const mrTex = mat.getMetallicRoughnessTexture();
+            const occlusionTex = mat.getOcclusionTexture();
+            const emissiveTex = mat.getEmissiveTexture();
+            return {
+                name: mat.getName() || "(unnamed)",
+                alphaMode: mat.getAlphaMode(),
+                doubleSided: mat.getDoubleSided(),
+                baseColorFactor: Array.from(mat.getBaseColorFactor()),
+                metallicFactor: mat.getMetallicFactor(),
+                roughnessFactor: mat.getRoughnessFactor(),
+                emissiveFactor: Array.from(mat.getEmissiveFactor()),
+                textures: {
+                    baseColor: baseColorTex ? baseColorTex.getName() || true : null,
+                    normal: normalTex ? normalTex.getName() || true : null,
+                    metallicRoughness: mrTex ? mrTex.getName() || true : null,
+                    occlusion: occlusionTex ? occlusionTex.getName() || true : null,
+                    emissive: emissiveTex ? emissiveTex.getName() || true : null,
+                },
+            };
+        });
+        // Animation details
+        const animations = root.listAnimations().map((anim) => {
+            const channels = anim.listChannels().map((ch) => {
+                const targetNode = ch.getTargetNode();
+                return {
+                    targetNode: targetNode ? targetNode.getName() || "(unnamed)" : null,
+                    targetPath: ch.getTargetPath(),
+                };
+            });
+            return {
+                name: anim.getName() || "(unnamed)",
+                channelCount: channels.length,
+                samplerCount: anim.listSamplers().length,
+                channels,
+            };
+        });
+        // Skin details
+        const skins = root.listSkins().map((skin) => {
+            const skeleton = skin.getSkeleton();
+            return {
+                name: skin.getName() || "(unnamed)",
+                jointCount: skin.listJoints().length,
+                skeleton: skeleton ? skeleton.getName() || "(unnamed)" : null,
+                jointNames: skin.listJoints().map((j) => j.getName() || "(unnamed)"),
+            };
+        });
+        // Scene hierarchy with transforms
+        function buildHierarchy(node) {
+            const mesh = node.getMesh();
+            const children = node.listChildren().map((child) => buildHierarchy(child));
+            return {
+                name: node.getName() || "(unnamed)",
+                type: mesh ? "Mesh" : "Node",
+                translation: Array.from(node.getTranslation()),
+                rotation: Array.from(node.getRotation()),
+                scale: Array.from(node.getScale()),
+                children,
+            };
+        }
+        const hierarchy = scene ? scene.listChildren().map((child) => buildHierarchy(child)) : [];
+        const result = {
+            file: resolvedPath,
+            summary,
+            materials,
+            textures: report.textures.properties,
+            animations,
+            skins,
+            scenes: report.scenes.properties,
+            meshes: report.meshes.properties,
+            extensionsUsed,
+            extensionsRequired,
+            hierarchy,
+        };
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=get-gltf-info.js.map

package/build/tools/get-gltf-info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-gltf-info.js","sourceRoot":"","sources":["../../src/tools/get-gltf-info.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAiB7D,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,QAAgB;IAChD,IAAI,CAAC;QACH,MAAM,YAAY,GAAG,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAChD,MAAM,EAAE,GAAG,MAAM,QAAQ,EAAE,CAAC;QAC5B,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;QAE3B,oCAAoC;QACpC,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAE5B,YAAY;QACZ,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC;QAEhD,aAAa;QACb,MAAM,KAAK,GAAG,IAAI,CAAC,QAAQ,EAAE,CAAC;QAC9B,MAAM,SAAS,GAAG,KAAK,CAAC,SAAS,IAAI,SAAS,CAAC;QAC/C,MAAM,WAAW,GAAG,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC;QAE3C,sCAAsC;QACtC,MAAM,KAAK,GAAG,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC;QACnC,IAAI,WAAW,GAAG,IAAI,CAAC;QACvB,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,MAAM,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;YAChC,WAAW,GAAG;gBACZ,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,GAAG,EAAE,MAAM,CAAC,GAAG;gBACf,UAAU,EAAE;oBACV,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAChC,CAAC,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;iBACjC;gBACD,MAAM,EAAE;oBACN,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBACtC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;oBACtC,CAAC,EAAE,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;iBACvC;aACF,CAAC;QACJ,CAAC;QAED,2BAA2B;QAC3B,IAAI,aAAa,GAAG,CAAC,CAAC;QACtB,IAAI,cAAc,GAAG,CAAC,CAAC;QACvB,IAAI,gBAAgB,GAAG,CAAC,CAAC;QACzB,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,MAAM,CAAC,UAAU,EAAE,CAAC;YAC5C,aAAa,IAAI,IAAI,CAAC,QAAQ,CAAC;YAC/B,cAAc,IAAI,IAAI,CAAC,YAAY,CAAC;YACpC,gBAAgB,IAAI,IAAI,CAAC,cAAc,CAAC;QAC1C,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC,MAAM,CAAC;QAClD,MAAM,aAAa,GAAG,MAAM,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC;QACzD,MAAM,YAAY,GAAG,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC;QACvD,MAAM,cAAc,GAAG,MAAM,CAAC,UAAU,CAAC,UAAU,CAAC,MAAM,CAAC;QAC3D,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,MAAM,CAAC;QAE1C,8CAA8C;QAC9C,IAAI,uBAAuB,GAAG,CAAC,CAAC;QAChC,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,GAAoC,CAAC;YACpD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;gBACnB,uBAAuB,IAAI,MAAM,CAAC,OAAO,CAAC;YAC5C,CAAC;QACH,CAAC;QACD,MAAM,oBAAoB,GAAG,UAAU,CAAC,CAAC,uBAAuB,GAAG,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC;QAE9F,aAAa;QACb,MAAM,cAAc,GAAG,IAAI,CAAC,kBAAkB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QACjF,MAAM,kBAAkB,GAAG,IAAI,CAAC,sBAAsB,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC;QAEzF,oBAAoB;QACpB,MAAM,gBAAgB,GAA4B;YAChD,KAAK,EAAE,cAAc,CAAC,QAAQ,CAAC,4BAA4B,CAAC;YAC5D,OAAO,EAAE,cAAc,CAAC,QAAQ,CAAC,yBAAyB,CAAC;YAC3D,SAAS,EAAE,cAAc,CAAC,QAAQ,CAAC,oBAAoB,CAAC;SACzD,CAAC;QAEF,mBAAmB;QACnB,MAAM,eAAe,GAAa,EAAE,CAAC;QACrC,IAAI,cAAc,GAAG,MAAM,EAAE,CAAC;YAC5B,eAAe,CAAC,IAAI,CAAC,wBAAwB,cAAc,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;QACnF,CAAC;QACD,IAAI,gBAAgB,GAAG,GAAG,EAAE,CAAC;YAC3B,eAAe,CAAC,IAAI,CAAC,0BAA0B,gBAAgB,GAAG,CAAC,CAAC;QACtE,CAAC;QACD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC;YAC7C,MAAM,MAAM,GAAG,GAAoC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC;YAC/B,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC;gBAChD,IAAI,KAAK,EAAE,CAAC;oBACV,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;oBACxE,IAAI,MAAM,GAAG,IAAI,EAAE,CAAC;wBAClB,eAAe,CAAC,IAAI,CAAC,YAAY,GAAG,CAAC,IAAI,IAAI,WAAW,iBAAiB,IAAI,GAAG,CAAC,CAAC;oBACpF,CAAC;gBACH,CAAC;YACH,CAAC;QACH,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,KAAK,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC;YACzD,eAAe,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;QAChF,CAAC;QACD,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC;YAChC,eAAe,CAAC,IAAI,CAAC,6DAA6D,CAAC,CAAC;QACtF,CAAC;QAED,UAAU;QACV,MAAM,OAAO,GAAG;YACd,QAAQ;YACR,SAAS;YACT,WAAW;YACX,cAAc;YACd,aAAa;YACb,SAAS;YACT,aAAa;YACb,YAAY;YACZ,cAAc;YACd,SAAS;YACT,gBAAgB;YAChB,oBAAoB;YACpB,WAAW;YACX,gBAAgB;YAChB,eAAe;SAChB,CAAC;QAEF,mBAAmB;QACnB,MAAM,SAAS,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE;YACjD,MAAM,YAAY,GAAG,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAC/C,MAAM,SAAS,GAAG,GAAG,CAAC,gBAAgB,EAAE,CAAC;YACzC,MAAM,KAAK,GAAG,GAAG,CAAC,2BAA2B,EAAE,CAAC;YAChD,MAAM,YAAY,GAAG,GAAG,CAAC,mBAAmB,EAAE,CAAC;YAC/C,MAAM,WAAW,GAAG,GAAG,CAAC,kBAAkB,EAAE,CAAC;YAE7C,OAAO;gBACL,IAAI,EAAE,GAAG,CAAC,OAAO,EAAE,IAAI,WAAW;gBAClC,SAAS,EAAE,GAAG,CAAC,YAAY,EAAE;gBAC7B,WAAW,EAAE,GAAG,CAAC,cAAc,EAAE;gBACjC,eAAe,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,kBAAkB,EAAE,CAAC;gBACrD,cAAc,EAAE,GAAG,CAAC,iBAAiB,EAAE;gBACvC,eAAe,EAAE,GAAG,CAAC,kBAAkB,EAAE;gBACzC,cAAc,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,iBAAiB,EAAE,CAAC;gBACnD,QAAQ,EAAE;oBACR,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;oBAC/D,MAAM,EAAE,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;oBACtD,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;oBACzD,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC,YAAY,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;oBAC/D,QAAQ,EAAE,WAAW,CAAC,CAAC,CAAC,WAAW,CAAC,OAAO,EAAE,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI;iBAC7D;aACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,oBAAoB;QACpB,MAAM,UAAU,GAAG,IAAI,CAAC,cAAc,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE;gBAC9C,MAAM,UAAU,GAAG,EAAE,CAAC,aAAa,EAAE,CAAC;gBACtC,OAAO;oBACL,UAAU,EAAE,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI;oBACnE,UAAU,EAAE,EAAE,CAAC,aAAa,EAAE;iBAC/B,CAAC;YACJ,CAAC,CAAC,CAAC;YACH,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,WAAW;gBACnC,YAAY,EAAE,QAAQ,CAAC,MAAM;gBAC7B,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM;gBACxC,QAAQ;aACT,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,eAAe;QACf,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;YAC1C,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;YACpC,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,WAAW;gBACnC,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,MAAM;gBACpC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC,CAAC,CAAC,IAAI;gBAC7D,UAAU,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,EAAE,IAAI,WAAW,CAAC;aACrE,CAAC;QACJ,CAAC,CAAC,CAAC;QAEH,kCAAkC;QAClC,SAAS,cAAc,CAAC,IAAU;YAChC,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;YAC5B,MAAM,QAAQ,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;YAC3E,OAAO;gBACL,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,IAAI,WAAW;gBACnC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM;gBAC5B,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;gBAC9C,QAAQ,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC;gBACxC,KAAK,EAAE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClC,QAAQ;aACT,CAAC;QACJ,CAAC;QAED,MAAM,SAAS,GAAG,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,EAAE,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAE1F,MAAM,MAAM,GAAG;YACb,IAAI,EAAE,YAAY;YAClB,OAAO;YACP,SAAS;YACT,QAAQ,EAAE,MAAM,CAAC,QAAQ,CAAC,UAAU;YACpC,UAAU;YACV,KAAK;YACL,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YAChC,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,UAAU;YAChC,cAAc;YACd,kBAAkB;YAClB,SAAS;SACV,CAAC;QAEF,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SAC5E,CAAC;IACJ,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACvE,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,UAAU,OAAO,EAAE,EAAE,CAAC;YAC/D,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC"}

package/build/tools/render-gltf.d.ts

@@ -0,0 +1,53 @@
+export interface RenderOptions {
+    yaw: number;
+    pitch: number;
+    roll: number;
+    resolution: number;
+    mode: "default" | "wireframe" | "normals";
+    textureOverrides?: Record<string, string>;
+}
+export interface NormalizationInfo {
+    scaleFactor: number;
+    originalDimensions: {
+        x: number;
+        y: number;
+        z: number;
+    };
+    originalCenter: {
+        x: number;
+        y: number;
+        z: number;
+    };
+}
+export declare function renderGltf(filePath: string, options: RenderOptions): Promise<{
+    content: ({
+        type: "text";
+        text: string;
+        data?: undefined;
+        mimeType?: undefined;
+    } | {
+        type: "image";
+        data: string;
+        mimeType: string;
+        text?: undefined;
+    })[];
+    isError?: undefined;
+} | {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+    isError: boolean;
+}>;
+/** Exposed for tests to shut down the singleton */
+export declare function disposeRenderer(): Promise<void>;
+/**
+ * Start a standalone HTTP server (no browser) for testing routes directly.
+ * Returns the base URL and a dispose function.
+ */
+export declare function startTestServer(): Promise<{
+    baseUrl: string;
+    buildAssetUrl: (filePath: string) => string;
+    dispose: () => void;
+}>;
+//# sourceMappingURL=render-gltf.d.ts.map

package/build/tools/render-gltf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-gltf.d.ts","sourceRoot":"","sources":["../../src/tools/render-gltf.ts"],"names":[],"mappings":"AAWA,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,IAAI,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,CAAC;IAC1C,gBAAgB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC3C;AAED,MAAM,WAAW,iBAAiB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACxD,cAAc,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACrD;AA4QD,wBAAsB,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa;;;;;;;;;;;;;;;;;;;GAiDxE;AAED,mDAAmD;AACnD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAErD;AAED;;;GAGG;AACH,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,OAAO,EAAE,MAAM,CAAC;IAChB,aAAa,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC;IAC5C,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB,CAAC,CA6FD"}

package/build/tools/render-gltf.js

@@ -0,0 +1,364 @@
+import fs from "node:fs";
+import http from "node:http";
+import { createRequire } from "node:module";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { validateFilePath } from "../utils/path-security.js";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const require = createRequire(import.meta.url);
+const MIME_TYPES = {
+    ".html": "text/html",
+    ".js": "application/javascript",
+    ".mjs": "application/javascript",
+    ".json": "application/json",
+    ".wasm": "application/wasm",
+    ".glb": "model/gltf-binary",
+    ".gltf": "model/gltf+json",
+    ".bin": "application/octet-stream",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".ktx2": "image/ktx2",
+    ".webp": "image/webp",
+    ".bmp": "image/bmp",
+};
+class PuppeteerRenderer {
+    server = null;
+    browser = null;
+    page = null;
+    port = 0;
+    readyPromise = null;
+    renderLock = Promise.resolve();
+    threePath = "";
+    async ensureReady() {
+        if (this.readyPromise)
+            return this.readyPromise;
+        this.readyPromise = this._init();
+        return this.readyPromise;
+    }
+    async _init() {
+        // Resolve three.js path — use require.resolve for vitest compatibility
+        const threeEntry = require.resolve("three");
+        // threeEntry is like /path/to/node_modules/three/build/three.module.js
+        this.threePath = path.resolve(threeEntry, "..", "..");
+        // Start local HTTP server
+        this.server = http.createServer((req, res) => this.handleRequest(req, res));
+        await new Promise((resolve) => {
+            this.server?.listen(0, "127.0.0.1", () => resolve());
+        });
+        const addr = this.server.address();
+        this.port = addr.port;
+        // Launch Puppeteer
+        const puppeteer = await import("puppeteer");
+        this.browser = await puppeteer.default.launch({
+            headless: true,
+            args: [
+                "--no-sandbox",
+                "--disable-setuid-sandbox",
+                "--disable-dev-shm-usage",
+                "--use-gl=angle",
+                "--use-angle=default",
+            ],
+        });
+        this.page = await this.browser.newPage();
+        // Navigate to renderer page
+        await this.page.goto(`http://127.0.0.1:${this.port}/renderer.html`, {
+            waitUntil: "networkidle0",
+        });
+        // Wait for renderer to be ready
+        await this.page.waitForFunction("window.rendererReady === true", {
+            timeout: 15000,
+        });
+    }
+    handleRequest(req, res) {
+        const url = new URL(req.url || "/", `http://127.0.0.1:${this.port}`);
+        const pathname = url.pathname;
+        if (pathname === "/renderer.html") {
+            const htmlPath = path.join(__dirname, "..", "renderer", "renderer.html");
+            this.serveFile(htmlPath, res);
+            return;
+        }
+        if (pathname.startsWith("/node_modules/three/")) {
+            const relPath = pathname.replace("/node_modules/three/", "");
+            const filePath = path.join(this.threePath, relPath);
+            // Security: ensure resolved path stays within three package
+            const resolved = path.resolve(filePath);
+            if (!resolved.startsWith(this.threePath)) {
+                res.writeHead(403);
+                res.end("Forbidden");
+                return;
+            }
+            this.serveFile(resolved, res);
+            return;
+        }
+        if (pathname.startsWith("/assets/")) {
+            // Route: /assets/{base64url-encoded-dir}/{relative-path}
+            const rest = pathname.slice("/assets/".length);
+            const slashIdx = rest.indexOf("/");
+            if (slashIdx === -1) {
+                res.writeHead(400);
+                res.end("Missing relative path");
+                return;
+            }
+            const encodedDir = rest.slice(0, slashIdx);
+            const relPath = decodeURIComponent(rest.slice(slashIdx + 1));
+            let baseDir;
+            try {
+                baseDir = Buffer.from(encodedDir, "base64url").toString("utf-8");
+            }
+            catch {
+                res.writeHead(400);
+                res.end("Invalid base64url directory encoding");
+                return;
+            }
+            const filePath = path.resolve(baseDir, relPath);
+            // Security: ensure resolved path stays within the base directory
+            if (!filePath.startsWith(path.resolve(baseDir) + path.sep) &&
+                filePath !== path.resolve(baseDir)) {
+                res.writeHead(403);
+                res.end("Forbidden: path escapes base directory");
+                return;
+            }
+            this.serveFile(filePath, res);
+            return;
+        }
+        res.writeHead(404);
+        res.end("Not found");
+    }
+    serveFile(filePath, res) {
+        try {
+            const data = fs.readFileSync(filePath);
+            const ext = path.extname(filePath).toLowerCase();
+            const contentType = MIME_TYPES[ext] || "application/octet-stream";
+            res.writeHead(200, { "Content-Type": contentType });
+            res.end(data);
+        }
+        catch {
+            res.writeHead(404);
+            res.end("File not found");
+        }
+    }
+    buildAssetUrl(filePath) {
+        const dir = path.dirname(filePath);
+        const filename = path.basename(filePath);
+        const encodedDir = Buffer.from(dir, "utf-8").toString("base64url");
+        return `http://127.0.0.1:${this.port}/assets/${encodedDir}/${encodeURIComponent(filename)}`;
+    }
+    async render(resolvedPath, options) {
+        await this.ensureReady();
+        // Serialize concurrent render calls
+        const task = this.renderLock.then(async () => {
+            const modelUrl = this.buildAssetUrl(resolvedPath);
+            // Build texture override URLs
+            let textureOverrideUrls;
+            if (options.textureOverrides) {
+                textureOverrideUrls = {};
+                for (const [slot, texPath] of Object.entries(options.textureOverrides)) {
+                    const resolvedTexPath = path.resolve(texPath);
+                    textureOverrideUrls[slot] = this.buildAssetUrl(resolvedTexPath);
+                }
+            }
+            // biome-ignore lint/style/noNonNullAssertion: page is guaranteed non-null after ensureReady()
+            const renderResult = await this.page.evaluate(async (opts) => {
+                const w = window;
+                return await w.renderModel(opts);
+            }, {
+                glbUrl: modelUrl,
+                width: options.resolution,
+                height: options.resolution,
+                yaw: options.yaw,
+                pitch: options.pitch,
+                roll: options.roll,
+                mode: options.mode,
+                textureOverrideUrls,
+            });
+            // Extract base64 from data URL
+            const base64 = renderResult.dataUrl.replace(/^data:image\/png;base64,/, "");
+            return {
+                normalization: renderResult.normalization,
+                pngBase64: base64,
+                warnings: renderResult.warnings || [],
+            };
+        });
+        this.renderLock = task;
+        return task;
+    }
+    async dispose() {
+        if (this.page) {
+            try {
+                await this.page.close();
+            }
+            catch { }
+            this.page = null;
+        }
+        if (this.browser) {
+            try {
+                await this.browser.close();
+            }
+            catch { }
+            this.browser = null;
+        }
+        if (this.server) {
+            this.server.close();
+            this.server = null;
+        }
+        this.readyPromise = null;
+    }
+}
+// Module-level singleton
+const renderer = new PuppeteerRenderer();
+// Cleanup on process exit
+function cleanup() {
+    renderer.dispose().catch(() => { });
+}
+process.on("exit", cleanup);
+process.on("SIGINT", () => {
+    cleanup();
+    process.exit(0);
+});
+process.on("SIGTERM", () => {
+    cleanup();
+    process.exit(0);
+});
+export async function renderGltf(filePath, options) {
+    try {
+        const resolvedPath = validateFilePath(filePath);
+        // Validate texture override paths if provided
+        if (options.textureOverrides) {
+            const supportedExts = [".png", ".jpg", ".jpeg", ".webp", ".bmp", ".ktx2"];
+            for (const [slot, texPath] of Object.entries(options.textureOverrides)) {
+                const resolvedTexPath = path.resolve(texPath);
+                if (!fs.existsSync(resolvedTexPath)) {
+                    throw new Error(`Texture override for '${slot}' not found: ${resolvedTexPath}`);
+                }
+                const ext = path.extname(resolvedTexPath).toLowerCase();
+                if (!supportedExts.includes(ext)) {
+                    throw new Error(`Unsupported texture format for '${slot}': ${ext}`);
+                }
+            }
+        }
+        const { normalization, pngBase64, warnings } = await renderer.render(resolvedPath, options);
+        const metadata = {
+            file: path.basename(resolvedPath),
+            resolution: options.resolution,
+            mode: options.mode,
+            normalization,
+            warnings,
+        };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(metadata),
+                },
+                {
+                    type: "image",
+                    data: pngBase64,
+                    mimeType: "image/png",
+                },
+            ],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+}
+/** Exposed for tests to shut down the singleton */
+export async function disposeRenderer() {
+    await renderer.dispose();
+}
+/**
+ * Start a standalone HTTP server (no browser) for testing routes directly.
+ * Returns the base URL and a dispose function.
+ */
+export async function startTestServer() {
+    const threeEntry = require.resolve("three");
+    const threePath = path.resolve(threeEntry, "..", "..");
+    let port = 0;
+    const server = http.createServer((req, res) => {
+        const url = new URL(req.url || "/", `http://127.0.0.1:${port}`);
+        const pathname = url.pathname;
+        if (pathname === "/renderer.html") {
+            const htmlPath = path.join(__dirname, "..", "renderer", "renderer.html");
+            serveStatic(htmlPath, res);
+            return;
+        }
+        if (pathname.startsWith("/node_modules/three/")) {
+            const relPath = pathname.replace("/node_modules/three/", "");
+            const filePath = path.join(threePath, relPath);
+            const resolved = path.resolve(filePath);
+            if (!resolved.startsWith(threePath)) {
+                res.writeHead(403);
+                res.end("Forbidden");
+                return;
+            }
+            serveStatic(resolved, res);
+            return;
+        }
+        if (pathname.startsWith("/assets/")) {
+            const rest = pathname.slice("/assets/".length);
+            const slashIdx = rest.indexOf("/");
+            if (slashIdx === -1) {
+                res.writeHead(400);
+                res.end("Missing relative path");
+                return;
+            }
+            const encodedDir = rest.slice(0, slashIdx);
+            const relPath = decodeURIComponent(rest.slice(slashIdx + 1));
+            let baseDir;
+            try {
+                baseDir = Buffer.from(encodedDir, "base64url").toString("utf-8");
+            }
+            catch {
+                res.writeHead(400);
+                res.end("Invalid base64url directory encoding");
+                return;
+            }
+            const filePath = path.resolve(baseDir, relPath);
+            if (!filePath.startsWith(path.resolve(baseDir) + path.sep) &&
+                filePath !== path.resolve(baseDir)) {
+                res.writeHead(403);
+                res.end("Forbidden: path escapes base directory");
+                return;
+            }
+            serveStatic(filePath, res);
+            return;
+        }
+        res.writeHead(404);
+        res.end("Not found");
+    });
+    function serveStatic(filePath, res) {
+        try {
+            const data = fs.readFileSync(filePath);
+            const ext = path.extname(filePath).toLowerCase();
+            const contentType = MIME_TYPES[ext] || "application/octet-stream";
+            res.writeHead(200, { "Content-Type": contentType });
+            res.end(data);
+        }
+        catch {
+            res.writeHead(404);
+            res.end("File not found");
+        }
+    }
+    await new Promise((resolve) => {
+        server.listen(0, "127.0.0.1", () => resolve());
+    });
+    port = server.address().port;
+    return {
+        baseUrl: `http://127.0.0.1:${port}`,
+        buildAssetUrl(filePath) {
+            const dir = path.dirname(filePath);
+            const filename = path.basename(filePath);
+            const encodedDir = Buffer.from(dir, "utf-8").toString("base64url");
+            return `http://127.0.0.1:${port}/assets/${encodedDir}/${encodeURIComponent(filename)}`;
+        },
+        dispose() {
+            server.close();
+        },
+    };
+}
+//# sourceMappingURL=render-gltf.js.map

package/build/tools/render-gltf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-gltf.js","sourceRoot":"","sources":["../../src/tools/render-gltf.ts"],"names":[],"mappings":"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"}

package/build/utils/gltf-io.d.ts

@@ -0,0 +1,6 @@
+import { NodeIO } from "@gltf-transform/core";
+/**
+ * Creates a NodeIO instance configured with all extensions and Draco decoder.
+ */
+export declare function createIO(): Promise<NodeIO>;
+//# sourceMappingURL=gltf-io.d.ts.map

package/build/utils/gltf-io.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-io.d.ts","sourceRoot":"","sources":["../../src/utils/gltf-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAI9C;;GAEG;AACH,wBAAsB,QAAQ,IAAI,OAAO,CAAC,MAAM,CAAC,CAOhD"}

package/build/utils/gltf-io.js

@@ -0,0 +1,13 @@
+import { NodeIO } from "@gltf-transform/core";
+import { ALL_EXTENSIONS } from "@gltf-transform/extensions";
+import draco3d from "draco3dgltf";
+/**
+ * Creates a NodeIO instance configured with all extensions and Draco decoder.
+ */
+export async function createIO() {
+    const io = new NodeIO().registerExtensions(ALL_EXTENSIONS);
+    const decoderModule = await draco3d.createDecoderModule();
+    io.registerDependencies({ "draco3d.decoder": decoderModule });
+    return io;
+}
+//# sourceMappingURL=gltf-io.js.map

package/build/utils/gltf-io.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gltf-io.js","sourceRoot":"","sources":["../../src/utils/gltf-io.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAC9C,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,OAAO,MAAM,aAAa,CAAC;AAElC;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,QAAQ;IAC5B,MAAM,EAAE,GAAG,IAAI,MAAM,EAAE,CAAC,kBAAkB,CAAC,cAAc,CAAC,CAAC;IAE3D,MAAM,aAAa,GAAG,MAAM,OAAO,CAAC,mBAAmB,EAAE,CAAC;IAC1D,EAAE,CAAC,oBAAoB,CAAC,EAAE,iBAAiB,EAAE,aAAa,EAAE,CAAC,CAAC;IAE9D,OAAO,EAAE,CAAC;AACZ,CAAC"}

package/build/utils/path-security.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Validates that a file path points to a readable glTF/GLB file.
+ * Returns the resolved absolute path.
+ */
+export declare function validateFilePath(filePath: string): string;
+//# sourceMappingURL=path-security.d.ts.map

package/build/utils/path-security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.d.ts","sourceRoot":"","sources":["../../src/utils/path-security.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsBzD"}

package/build/utils/path-security.js

@@ -0,0 +1,25 @@
+import fs from "node:fs";
+import path from "node:path";
+/**
+ * Validates that a file path points to a readable glTF/GLB file.
+ * Returns the resolved absolute path.
+ */
+export function validateFilePath(filePath) {
+    const resolved = path.resolve(filePath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`File not found: ${resolved}`);
+    }
+    const ext = path.extname(resolved).toLowerCase();
+    if (ext !== ".gltf" && ext !== ".glb") {
+        throw new Error(`Not a glTF file (expected .gltf or .glb, got ${ext || "no extension"}): ${resolved}`);
+    }
+    // Check readability
+    try {
+        fs.accessSync(resolved, fs.constants.R_OK);
+    }
+    catch {
+        throw new Error(`File is not readable: ${resolved}`);
+    }
+    return resolved;
+}
+//# sourceMappingURL=path-security.js.map

package/build/utils/path-security.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-security.js","sourceRoot":"","sources":["../../src/utils/path-security.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B;;;GAGG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,MAAM,QAAQ,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;IAExC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;QAC7B,MAAM,IAAI,KAAK,CAAC,mBAAmB,QAAQ,EAAE,CAAC,CAAC;IACjD,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;IACjD,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;QACtC,MAAM,IAAI,KAAK,CACb,gDAAgD,GAAG,IAAI,cAAc,MAAM,QAAQ,EAAE,CACtF,CAAC;IACJ,CAAC;IAED,oBAAoB;IACpB,IAAI,CAAC;QACH,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC7C,CAAC;IAAC,MAAM,CAAC;QACP,MAAM,IAAI,KAAK,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "gltf-mcp",
+  "version": "0.2.0",
+  "description": "MCP server for inspecting and rendering glTF/GLB files",
+  "type": "module",
+  "bin": {
+    "gltf-mcp": "./build/index.js"
+  },
+  "main": "./build/index.js",
+  "files": [
+    "build"
+  ],
+  "scripts": {
+    "build": "tsc && mkdir -p build/renderer && cp src/renderer/renderer.html build/renderer/renderer.html",
+    "dev": "tsc --watch",
+    "start": "node build/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "biome check src/ tests/",
+    "lint:fix": "biome check --write src/ tests/",
+    "format": "biome format --write src/ tests/",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "gltf",
+    "glb",
+    "3d",
+    "model-context-protocol"
+  ],
+  "author": "Felix Z",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/elixr-games/gltf-mcp.git"
+  },
+  "homepage": "https://elixr-games.github.io/gltf-mcp/",
+  "bugs": {
+    "url": "https://github.com/elixr-games/gltf-mcp/issues"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@gltf-transform/core": "^4.3.0",
+    "@gltf-transform/extensions": "^4.3.0",
+    "@gltf-transform/functions": "^4.3.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "draco3dgltf": "^1.5.7",
+    "puppeteer": "^24.2.0",
+    "three": "^0.172.0",
+    "zod": "^3.24.0"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.3.14",
+    "@types/node": "^22.0.0",
+    "@types/pngjs": "^6.0.5",
+    "@vitest/coverage-v8": "^4.0.18",
+    "pngjs": "^7.0.0",
+    "sharp": "^0.34.0",
+    "typescript": "^5.7.0",
+    "vitepress": "^1.6.4",
+    "vitest": "^3.0.0"
+  }
+}