threejs-devtools-mcp

Inspects and modifies Three.js scenes in real time via an MCP server.

4|Updated May 16, 2026
One-click install
npx skills add https://github.com/reason-machines/devtools-skills --skill threejs-devtools-mcp-reason-machines
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: threejs-devtools-mcp
Source: https://github.com/reason-machines/devtools-skills/tree/main/skills/threejs-devtools-mcp
Command: npx skills add https://github.com/reason-machines/devtools-skills --skill threejs-devtools-mcp-reason-machines

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires threejs-devtools-mcp.

What problem does it solve? Debugging Three.js scenes normally requires manual console logging and guesswork to find invisible objects, broken shaders, or performance bottlenecks. This Skill gives AI agents direct access to a running scene through Chrome DevTools Protocol, enabling real-time inspection and editing without code changes. ## Core Features & Use Cases - Scene Inspection: Query the full scene graph, object details, cameras, lights, and materials with 59 MCP tools. - Material & Shader Editing: Update colors, metalness, roughness, and custom vertex/fragment shaders live in the browser. - Performance Monitoring: Track FPS, draw calls, triangles, and memory usage to diagnose rendering bottlenecks and leaks. - Use Case: A developer's GLTF character loads but is invisible and the scene runs at 15 FPS. The agent runs check_common_issues, finds a zero-scale transform, fixes it, then uses get_render_info to identify 450 draw calls and recommends geometry merging. ## Quick Start Ask the AI to show the scene tree and check for common issues in your running Three.js app after installing the MCP server with npx threejs-devtools-mcp.

Frequently Asked Questions about threejs-devtools-mcp

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I debug invisible objects in a Three.js scene?▼

Use get_scene_tree to locate the object, then run check_common_issues to detect problems like zero scale, missing materials, or visibility flags. Fix issues with toggle_object_visibility or update_object_transform using the object's hierarchical path.

How to monitor Three.js performance and find rendering bottlenecks?▼

Call get_performance_stats for FPS and frame time, get_render_info for draw calls and triangle counts, and get_memory_info for geometry and texture usage. High draw calls suggest merging geometries; high triangle counts suggest using LOD.

Does threejs-devtools-mcp work with React Three Fiber?▼

Yes, it works with React Three Fiber and any Three.js framework with zero code changes. Name meshes with the name prop or ref so tools can address them via paths like Scene/rotating-box.

Why do threejs-devtools-mcp tools return not connected?▼

The browser tab opened by the MCP server must stay open because tools communicate through a WebSocket bridge injected into the page. Check the browser console for WebSocket errors and restart the MCP server if the connection drops.

Can I edit Three.js shaders in real time from an AI agent?▼

Yes, use get_shaders to list ShaderMaterial and RawShaderMaterial instances, then update_shader to replace vertex and fragment source code and uniform values live in the running scene.