Three.js DevTools MCP
Three.js DevTools MCP — MCP-сервер сообщества (автор — DmitriyGolub). Просмотр и редактирование сцен Three.js, материалов, шейдеров и света в реальном времени из ИИ-агента. Лицензия MIT.
Опубликовано 13.11.2026 · Обновлено 14.11.2026 · Проверено 13.11.2026
Кратко о сервере
- Разработчик
- DmitriyGolub
- Лицензия
- MIT
- Транспорт
- stdio
- Авторизация
- none
- ОС
- Не указана
- Языки
- typescript
Уровень риска: medium
Читает package.json проекта, открывает браузер и подключается к странице через локальный мост; код меняет ИИ по запросу.
Настройка клиентов
{
"code": "{\n \"mcpServers\": {\n \"threejs-devtools-mcp\": {\n \"command\": \"npx\",\n \"args\": [\"-y\", \"threejs-devtools-mcp\"]\n }\n }\n}",
"file": ".cursor/mcp.json",
"lang": "json",
"notes": "Или HTTP-транспорт",
"verified": "docs"
}
Что умеет
threejs-devtools-mcp — MCP-сервер для исследования сцен Three.js в реальном времени: он позволяет пробовать изменения прямо в браузере и превращать удачные варианты в код. 69 инструментов охватывают объекты, материалы, шейдеры, текстуры, анимацию, производительность и память, а также аудит сайтов, захват кадров для видео и интеграцию с Playwright. Проект менять не нужно: сервер работает с обычным Three.js и React Three Fiber, на WebGLRenderer и WebGPURenderer.
Каждый инструмент помечен по тому, затрагивает ли он ваш код:
- Осмотр —
scene_tree,material_details,web_audit, снимки экрана; код не меняется. - Живой предпросмотр —
set_material_property,set_light,set_cameraи другие; код не меняется, изменения пропадают при перезагрузке страницы. - Визуальная отладка — каркасный режим, ограничивающие рамки, хелперы, оверлей; в коде не нужны.
- Для кода —
pending_changesиgltf_to_r3f: результат ИИ записывает в исходники.
Все изменения предпросмотра записываются: pending_changes возвращает каждое как «было → стало» с готовым кодом для Three.js и React Three Fiber и указанием места в проекте, а revert_changes откатывает их в браузере.
web_audit ищет размытый холст (pixel ratio, отсутствие обработки ресайза), расход батареи (рендер в простое или вне экрана), тяжёлые текстуры, дорогие тени, неверное цветовое пространство и избыток вызовов отрисовки — с исправлением для каждой находки. capture_frames записывает последовательность кадров для промо-роликов с виртуальным временем, так что видео получается плавным при 30 или 60 кадрах в секунду даже на медленной сцене, и выдаёт команду ffmpeg для MP4 или WebM.
Готовые сценарии появляются в клиентах как слэш-команды: inspect-scene, try-look, apply-to-code, web-perf-audit, prepare-video, debug-invisible, playwright-setup. Встроенный оверлей показывает статистику производительности, граф сцены и редактор материалов.
Кому подойдёт
- Разработчикам 3D-сайтов и веб-игр на Three.js и React Three Fiber.
- Технохудожникам, подбирающим материалы и свет вживую.
- Командам, готовящим промо-видео из интерактивных сцен.
Похожие серверы — в категории 3D и геймдев.
Установка
Нужен Node.js с npx. Добавьте сервер в клиент, затем запустите dev-сервер проекта как обычно (npm run dev). MCP-сервер сам определит порт по package.json и откроет браузер на localhost:9222 с подключённым мостом. Держите вкладку открытой: сервер общается со сценой через WebSocket, и при закрытии вкладки инструменты перестают работать. Можно также использовать Chrome, запущенный сервером, или собственные тесты Playwright и Puppeteer.
Подключение к клиентам
Конфиги приведены дословно из README. Подробнее — в инструкции как подключить MCP.
claude mcp add threejs-devtools-mcp -- npx threejs-devtools-mcpФайлы: claude_desktop_config.json для Claude Desktop, .vscode/mcp.json для VS Code, opencode.json в проекте для OpenCode. Тот же JSON, что для Claude Desktop, кладётся в .cursor/mcp.json для Cursor и в ~/.codeium/windsurf/mcp_config.json для Windsurf.
Проверка
Запустите dev-сервер и спросите: «Покажи дерево сцены» — должен сработать scene_tree.
Примеры задач
Почему моя модель невидима? Проверь материал, камеру и ограничивающую рамку.Попробуй машину в красном цвете, а если понравится — перенеси изменение в код.Риски
- Браузер и локальный проект. Сервер читает
package.json, открывает браузер и подключается к странице через локальный мост. - Изменения кода. Сам сервер код не меняет, но по запросу ИИ переносит изменения предпросмотра в исходники — проверяйте диффы.
- Изменения предпросмотра временные и пропадают при перезагрузке страницы.
Частые вопросы
Нужно ли менять мой проект?
Нет, мост внедряется в браузер, проект остаётся без изменений.
Поддерживается ли React Three Fiber?
Да, а gltf_to_r3f превращает модели glTF в компоненты R3F.
Что будет, если закрыть вкладку?
Инструменты перестанут работать, пока страница снова не откроется.
Основы протокола — на странице что такое MCP-сервер.
Похожие MCP-серверы
MCP for Blender
MCP-сервер сообщества для Blender: создание сцен, материалов и объектов, Python-код и ресурсы Poly Haven.
MCP for Unity
MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.
AI Game Developer (Unity-MCP)
MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.
MCP Unity
Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.