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 проекта, открывает браузер и подключается к странице через локальный мост; код меняет ИИ по запросу.

Настройка клиентов

cursor
{
    "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.

Риск: high Лицензия: MIT ★ 34 950

MCP for Unity

MCP-сервер сообщества для редактора Unity: сцены, объекты, C#-скрипты, ассеты, тесты и сборка.

Риск: high Лицензия: MIT ★ 16 062

AI Game Developer (Unity-MCP)

MCP-сервер сообщества для Unity с генерацией навыков под проект, облачным входом и работой в собранной игре.

Риск: high Лицензия: Apache-2.0 ★ 4 663

MCP Unity

Плагин сообщества для Unity 6 с MCP-сервером на Node.js: объекты, сцены, префабы, тесты и логи консоли.

Риск: high Лицензия: MIT ★ 2 019

Источники