用途：threejs-devtools-mcp 是一个 MCP 服务器，让 AI 智能体实时检查和修改 Three.js 场景，适用于原生 Three.js、React Three Fiber 及任意框架，无需修改代码，通过 Chrome DevTools Protocol 连接。
主要能力：提供 59 个工具，涵盖场景检查（场景树、对象详情、查找对象、相机、灯光）、材质与着色器管理（读取/更新材质、着色器、纹理）、对象操作（变换、可见性、包围盒、克隆）、性能监控（FPS、帧时间、内存、绘制调用、三角形）、动画控制（播放、暂停、状态）、代码生成（React 组件、材质代码、场景导出）以及调试（覆盖层、常见问题检测、世界坐标）。
使用方式：先启动开发服务器，MCP 服务器会自动检测端口并打开 Chrome 的 localhost:9222，浏览器标签页需保持打开，通过 WebSocket 桥接通信。安装示例：Claude Code 使用 claude mcp add threejs-devtools-mcp -- npx threejs-devtools-mcp；其他客户端在对应配置文件中添加 command 为 npx、args 为 ["-y", "threejs-devtools-mcp"] 的服务器配置。对象通过层级路径标识，如 Scene/Player。
适用场景：调试不可见对象、编辑材质、优化性能、调试自定义着色器、从 GLTF/GLB 生成 React 组件。
限制：浏览器标签页必须保持打开；对象未命名时路径显示为 (unnamed)；材质修改可能受多对象共享或 transparent 属性影响；性能监控需 renderer.info.autoReset 未禁用；移除对象时应调用 dispose() 避免内存泄漏。配置可通过项目根目录的 threejs-devtools.config.json 或环境变量调整。