{"report":{"v":1,"package":"threejs-devtools-mcp","version":"0.5.0","ranAt":"2026-11-16T11:28:11.179Z","install":{"ok":true,"bin":"threejs-devtools-mcp","integrity":"sha512-z27jf+a+5A5qgnVFAfUzy827SStziV+VQXXVUhOyQ/+gBxJvgoQ4KNMnV2QqrDjEPEfihvsSIKdNWq9+TGMPSQ==","deps":119,"scripts":[],"bins":["threejs-devtools-mcp","threejs-devtools-mcp-http"],"license":"MIT","engines":"node >=22.18","repository":"https://github.com/DmitriyGolub/threejs-devtools-mcp.git"},"start":{"ok":true,"ms":174,"serverName":"threejs-devtools-mcp","serverVersion":"0.5.0","protocol":"2025-06-18","stderr":"[threejs-devtools] Could not detect dev port, using 3000\n[threejs-devtools-mcp] Proxy: http://localhost:9222 → http://localhost:3000\n[threejs-devtools] Opened http://localhost:9222 in system browser\n"},"tools":[{"name":"scene_tree","description":"[INSPECT] Read-only.\nScene hierarchy. Compact text tree by default (~2KB); compact=false for full JSON with positions/geometry.","params":["depth","types","maxChildren","compact"]},{"name":"object_details","description":"[INSPECT] Read-only.\nDetailed info about one object by name, uuid, or dot path.","params":["name","uuid","path"]},{"name":"find_objects","description":"[INSPECT] Read-only.\nSearch objects by type, material, visibility, name pattern, or custom property.","params":["type","material","visible","namePattern","property","value","hasGeometry","minChildren","limit"]},{"name":"raycast","description":"[INSPECT] Read-only.\nCast a ray from the camera through screen coordinates and return hit objects.","params":["x","y","maxHits"]},{"name":"click_inspect","description":"[INSPECT] Read-only.\nClick-to-inspect: the cursor becomes a crosshair — tell the user to click an object in the 3D view. Returns that object.","params":["timeout"]},{"name":"scene_diff","description":"[INSPECT] Read-only.\nCompare scene state over time: first call saves a snapshot, next call lists added/removed/modified objects.","params":["action"]},{"name":"layer_details","description":"[INSPECT] Read-only.\nCamera layer mask and objects with non-default layers.","params":[]},{"name":"set_object_transform","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nSet position, rotation, scale, or visibility of an object.","params":["name","uuid","position","rotation","scale","visible"]},{"name":"set_layers","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nSet layers on an object or the camera.","params":["name","uuid","target","layer","enabled","mask"]},{"name":"material_list","description":"[INSPECT] Read-only.\nAll materials in the scene with type, color, transparency.","params":[]},{"name":"material_details","description":"[INSPECT] Read-only.\nFull material properties: colors, PBR/physical params, maps, uniforms, defines, NodeMaterial (TSL) slots.","params":["name","uuid"]},{"name":"shader_list","description":"[INSPECT] Read-only.\nCompiled shader programs with their materials (WebGL).","params":[]},{"name":"shader_source","description":"[INSPECT] Read-only.\nVertex/fragment GLSL source and uniforms of a material. NodeMaterial (TSL) has no GLSL — use material_details.","params":["materialName","materialUuid"]},{"name":"texture_list","description":"[INSPECT] Read-only.\nAll textures: size, format, wrap, filter settings.","params":[]},{"name":"texture_details","description":"[INSPECT] Read-only.\nDetailed info about one texture.","params":["name","uuid"]},{"name":"texture_preview","description":"[INSPECT] Read-only.\nShow a texture as a PNG image. Use texture_list to find names/UUIDs.","params":["name","uuid","maxSize"]},{"name":"set_material_property","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nSet a material property. Accepts the material name or the name of a mesh that uses it.","params":["name","uuid","property","value"]},{"name":"set_uniform","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nSet a ShaderMaterial uniform.","params":["name","uuid","uniform","value"]},{"name":"set_texture","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange texture sampling and transform: wrap, filter, anisotropy, repeat, offset, rotation, colorSpace.","params":["name","uuid","wrapS","wrapT","minFilter","magFilter","anisotropy","flipY","colorSpace","repeat","offset","rotation"]},{"name":"shadow_details","description":"[INSPECT] Read-only.\nShadow maps: global settings, per-light bias/mapSize/camera frustum, casters and receivers.","params":[]},{"name":"scene_background","description":"[INSPECT] Read-only.\nScene background, environment map (IBL), backgroundBlurriness/Intensity, color management.","params":[]},{"name":"env_map_details","description":"[INSPECT] Read-only.\nEnvironment maps: scene.environment, scene.background, per-material envMap.","params":[]},{"name":"fog_details","description":"[INSPECT] Read-only.\nScene fog: type (Fog/FogExp2), color, near/far or density.","params":[]},{"name":"set_light","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange a light: color, intensity, position, castShadow, groundColor (HemisphereLight).","params":["name","uuid","color","intensity","position","castShadow","groundColor"]},{"name":"set_shadow","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange shadow casting/receiving on any object, and bias/mapSize/shadow camera on lights.","params":["name","uuid","castShadow","receiveShadow","bias","normalBias","radius","blurSamples","mapSize","cameraNear","cameraFar","cameraLeft","cameraRight","cameraTop","cameraBottom"]},{"name":"set_fog","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange scene fog (color, near/far or density) and the background color.","params":["color","near","far","density","background"]},{"name":"camera_details","description":"[INSPECT] Read-only.\nActive camera: type, position, FOV, near/far, aspect.","params":[]},{"name":"renderer_info","description":"[INSPECT] Read-only.\nRenderer stats and backend (WebGL / WebGPU): draw calls, triangles, memory, capabilities.","params":[]},{"name":"renderer_settings","description":"[INSPECT] Read-only.\nRenderer configuration: toneMapping, exposure, colorSpace, shadowMap, pixelRatio.","params":[]},{"name":"clipping_details","description":"[INSPECT] Read-only.\nClipping planes: renderer global, per-material, ClippingGroup objects.","params":[]},{"name":"postprocessing_list","description":"[INSPECT] Read-only.\nEffectComposer passes: render passes, shader passes, effects (bloom, SSAO, …).","params":[]},{"name":"set_camera","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange the active camera: position, rotation, FOV, near/far, zoom, ortho bounds.","params":["position","rotation","fov","near","far","zoom","aspect","left","right","top","bottom"]},{"name":"set_renderer","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange renderer settings: tone mapping, exposure, color space, pixel ratio, shadows.","params":["toneMapping","toneMappingExposure","outputColorSpace","pixelRatio","sortObjects","localClippingEnabled","shadowMapEnabled","shadowMapType"]},{"name":"set_clipping","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange clipping planes on the renderer (global) or a material.","params":["target","name","uuid","localClippingEnabled","planes","clipIntersection","clipShadows","enabled"]},{"name":"set_postprocessing","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nEnable/disable passes, set pass uniforms or effect parameters. Without a pass, lists passes.","params":["passIndex","passName","enabled","uniforms","effectIndex","effectParams"]},{"name":"geometry_details","description":"[INSPECT] Read-only.\nGeometry of a mesh: vertices, attributes, index, bounding box, morph attributes.","params":["name","uuid"]},{"name":"instanced_mesh_details","description":"[INSPECT] Read-only.\nInstancedMesh: count, capacity, sample transforms, instance colors and custom attributes.","params":["name","uuid","sampleCount","startIndex"]},{"name":"batched_mesh_details","description":"[INSPECT] Read-only.\nBatchedMesh: geometry counts, draw ranges, instance visibility. Lists all if no name/uuid.","params":["name","uuid"]},{"name":"morph_targets","description":"[INSPECT] Read-only.\nMeshes with morph targets: target names and current influences.","params":[]},{"name":"skeleton_details","description":"[INSPECT] Read-only.\nSkeletons and bones of SkinnedMesh objects.","params":[]},{"name":"animation_details","description":"[INSPECT] Read-only.\nAnimationMixers with their actions, clips, weights and playback state.","params":[]},{"name":"set_instanced_mesh","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nChange InstancedMesh count, visibility, frustumCulled.","params":["name","uuid","count","visible","frustumCulled"]},{"name":"set_morph_target","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nSet a morph target influence.","params":["name","uuid","index","targetName","influence"]},{"name":"set_animation","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nControl playback: mixer timeScale/time, action play/stop/pause/weight by clip name.","params":["mixerIndex","timeScale","time","clipName","actionWeight","actionTimeScale","actionPaused","play","stop"]},{"name":"web_audit","description":"[INSPECT] Read-only.\nWebsite health check: pixel ratio, canvas resize, idle/off-screen rendering, antialias cost, oversized or uncompressed textures, shadow cost, color space, draw calls. Each finding has a concrete fix.","params":[]},{"name":"performance_snapshot","description":"[INSPECT] Read-only.\nDraw calls, triangles, instanced meshes, object counts by type.","params":[]},{"name":"perf_monitor","description":"[INSPECT] Read-only.\nRecord FPS and frame times for N seconds: avg/min/max, percentiles, spikes, jank.","params":["duration","includeFrameTimes"]},{"name":"draw_call_breakdown","description":"[INSPECT] Read-only.\nPer-object draw call and triangle cost, sorted by cost. Flags multi-material objects and hidden geometry.","params":[]},{"name":"memory_stats","description":"[INSPECT] Read-only.\nGPU memory: geometry buffers, texture VRAM, instance data, top textures by size.","params":[]},{"name":"dispose_check","description":"[INSPECT] Read-only.\nLeak detection: geometries/textures tracked by the renderer but no longer in the scene.","params":[]},{"name":"console_capture","description":"[INSPECT] Read-only.\nRecent browser console output (log/warn/error).","params":["clear","level","limit"]},{"name":"toggle_overlay","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nIn-browser inspector panel: live FPS, draw calls, scene tree, materials, lights. Clicking a tree item highlights it.","params":["enabled"]},{"name":"overlay_selected","description":"[INSPECT] Read-only.\nEverything about the object the user selected in the overlay: materials, geometry, transforms, textures, uniforms, shadows.","params":[]},{"name":"highlight_object","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nHighlight an object with wireframe, or toggle its visibility, to point it out.","params":["name","uuid","mode","enabled"]},{"name":"toggle_wireframe","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nWireframe on all materials or one object.","params":["name","uuid","enabled"]},{"name":"bounding_boxes","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nShow/hide bounding boxes — debug frustum culling and object bounds.","params":["name","uuid","enabled","clear","color","recursive","onlyVisible","limit"]},{"name":"add_helper","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nAdd a debug helper to an object: box, axes, skeleton, arrow, grid, camera frustum, light helpers, plane.","params":["target","targetUuid","type","size","color","direction","origin","length","divisions"]},{"name":"remove_helper","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nRemove a helper added with add_helper.","params":["helperId"]},{"name":"run_js","description":"[DEBUG VISUAL] Temporary visual aid in the browser. Nothing to put in code.\nRun JavaScript in the page with scene, renderer, camera, gl in scope; `return` a value to get it back. Changes made here are NOT recorded in pending_changes — prefer the set_* tools for anything the user may want to keep.","params":["code"]},{"name":"take_screenshot","description":"[INSPECT] Read-only.\nScreenshot of the current scene (also saved as PNG in screenshots/).","params":["width","height"]},{"name":"annotated_screenshot","description":"[INSPECT] Read-only.\nScreenshot with object names drawn at their screen positions ([M]esh, [L]ight, [G]roup, [C]amera). Best for understanding layout.","params":["width","height"]},{"name":"capture_frames","description":"[INSPECT] Read-only.\nRecord a frame sequence for a video. Time is virtualised, so frames are exactly 1/fps apart and smooth even if rendering is slow. Saves numbered images to screenshots/sequence-<time>/ and returns an ffmpeg command.","params":["fps","duration","format","width","height"]},{"name":"scene_export","description":"[INSPECT] Read-only.\nExport the scene or one object as GLB/glTF into screenshots/. Needs GLTFExporter in the app (the error explains setup).","params":["name","uuid","binary"]},{"name":"pending_changes","description":"[FOR CODE] Output is meant to be written into the project source files.\nEverything changed with live-preview tools since the last clear: before → after per property, plus ready-to-paste code (vanilla Three.js and/or React Three Fiber) and where to find each target. Use it to persist a preview into source; call again with clear=true once the code is updated.","params":["style","clear"]},{"name":"revert_changes","description":"[LIVE PREVIEW] Changes the scene in the browser only — NOT saved to source code, lost on reload. Recorded in pending_changes (→ code edits) and undoable with revert_changes.\nUndo live-preview changes in the browser (all, or selected ids from pending_changes), newest first.","params":["ids"]},{"name":"gltf_to_r3f","description":"[FOR CODE] Output is meant to be written into the project source files.\nConvert a GLB/glTF file into a React Three Fiber component (like gltfjsx).","params":["filePath","typescript","preload"]},{"name":"bridge_status","description":"[CONNECTION] Configures the devtools server.\nBridge connection, proxy target, and how to attach Playwright to the same browser.","params":[]},{"name":"set_dev_port","description":"[CONNECTION] Configures the devtools server.\nPoint the proxy at another local dev server port.","params":["port"]},{"name":"set_dev_url","description":"[CONNECTION] Configures the devtools server.\nInspect a remote Three.js app by URL. Source code changes are not possible in remote mode.","params":["url"]}],"toolsHash":"8c7c05cfc1da8508b255f7daf669e262098351fb95f0a5828a2666a376390639","wrote":[],"callsAt":"2026-11-16T11:28:22.031Z","calls":[{"tool":"find_objects","ok":false,"ms":4,"bytes":0,"error":"tool reported an error: Error: No Three.js app connected.\nOpen http://localhost:9222 in your browser.\nIf the page is already open, try a hard refresh (Ctrl+Shift+R) to reload the bridge script. Multiple open tabs can also ca"},{"tool":"material_list","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: No Three.js app connected.\nOpen http://localhost:9222 in your browser.\nIf the page is already open, try a hard refresh (Ctrl+Shift+R) to reload the bridge script. Multiple open tabs can also ca"},{"tool":"shader_list","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: No Three.js app connected.\nOpen http://localhost:9222 in your browser.\nIf the page is already open, try a hard refresh (Ctrl+Shift+R) to reload the bridge script. Multiple open tabs can also ca"},{"tool":"texture_list","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: Error: No Three.js app connected.\nOpen http://localhost:9222 in your browser.\nIf the page is already open, try a hard refresh (Ctrl+Shift+R) to reload the bridge script. Multiple open tabs can also ca"},{"tool":"renderer_info","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: Error: No Three.js app connected.\nOpen http://localhost:9222 in your browser.\nIf the page is already open, try a hard refresh (Ctrl+Shift+R) to reload the bridge script. Multiple open tabs can also ca"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":69,"wrote":0,"callsTried":5,"callsAnswered":0,"callContacts":[]},"history":[{"package":"threejs-devtools-mcp","version":"0.5.0","ranAt":"2026-11-16T11:28:11.179Z","outcome":"started","tools":69,"contacts":0,"flags":0,"serious":0,"toolsHash":"8c7c05cfc1da8508b255f7daf669e262098351fb95f0a5828a2666a376390639"}],"page":"https://bragproof.smaverk.com/r/threejs-devtools-mcp"}