Embody MCP
Embody и Envoy: встроенный в TouchDesigner MCP-сервер, через который агент строит и отлаживает живые сети операторов
- 219 ★ репозитория
- Последний коммит
- MIT
Расширенный доступ
Почему такой уровень
- Агент меняет живую сессию TouchDesigner и записывает файлы проекта на диск
- Convoy разрешает управлять другими узлами и запускать их, поэтому включать его стоит только в доверенной сети
Установка
- Работает в
Ручная установка
Скачай `.tox` Embody из папки release репозитория, перетащи его в проект TouchDesigner и пройди мастер настройки, выбрав Envoy и свой агент. После этого проверь, что в корне проекта появился `.mcp.json`.
Доступ и проверки
Как мы проверяемРасширенный доступИнструмент запускает код или ходит в сеть, а внешние данные только читает.
- Агент меняет живую сессию TouchDesigner и записывает файлы проекта на диск
- Convoy разрешает управлять другими узлами и запускать их, поэтому включать его стоит только в доверенной сети
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Embody — набор инструментов для TouchDesigner. Envoy, его встроенный MCP-сервер, дает Claude Code, Codex, OpenCode, Gemini, Cursor и Windsurf прямой доступ к живой сессии: 70 инструментов, чтобы создавать операторы, соединять их, менять параметры и отлаживать сеть. Сервер запускается на `127.0.0.1:9870` и сам пишет `.mcp.json` в корне проекта (мост STDIO, поэтому инструменты видны и до старта TouchDesigner). Сам Embody выносит помеченные операторы в файлы на диске, повторяющие иерархию сети, так что можно ветвить идеи и возвращать вчерашнее состояние. Формат TDXN выгружает сеть в читаемый YAML, который агент понимает и который сравнивается через diff. Convoy дает нескольким узлам Embody в доверенной локальной сети находить и запускать друг друга.
Для кого. Художникам и разработчикам интерактивных инсталляций в TouchDesigner, которые хотят собирать сети вместе с агентом и хранить их в файлах под контролем версий.
Подходит, если
- Агент создает цепочку операторов для видеопотока и выставляет параметры, а вы смотрите, как сеть растет
- Нужно сравнить две версии сети через diff, поэтому она выгружается в читаемый TDXN
- Два подхода к проекту ветвятся в файлах на диске, и вы возвращаетесь к вчерашнему состоянию
- Рендер-узел без монитора ставится одной командой и управляется удаленно из одной сессии агента
Не подходит, если
- Работа идет без TouchDesigner: инструмент встраивается в среду и без нее бесполезен
- Нужна версия TouchDesigner старше 2025.33230: поддерживаются только новые сборки
- Сеть слишком большая, чтобы выгружать ее в файлы целиком: экстернализация идет по пометкам, и без них ничего не пишется
Пример запроса к агенту
Создай в моем проекте цепочку из Movie File In, Level и Out, выставь яркость 1.2 и покажи структуру сетиMCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Ограничения
Нужен TouchDesigner версии 2025.33230 и новее на Windows или macOS. Embody ставят скачиванием `.tox` из папки `/release` и перетаскиванием в проект, после чего открывается мастер настройки. Экстернализация включается по пометкам, пока оператор не помечен, на диск ничего не пишется. В режиме Export-on-Save файл `.toe` остается главным при открытии, а Roundtrip восстанавливает сети TDXN из файлов. Convoy предназначен для доверенной локальной сети. Среда Python строится для каждого проекта отдельно, а обновления Embody ставит сам по кнопке. Лицензия MIT.
Как отключить. Выключите параметр Envoy Enable в компоненте Embody и удалите запись из `.mcp.json`. Компонент удаляют из проекта, а экстернализованные файлы остаются на диске.
Частые вопросы
Как подключить Envoy к Claude Code?
Перетащите `.tox` Embody в проект и выберите ассистента в мастере настройки. Envoy запустит сервер на `127.0.0.1:9870` и сам запишет `.mcp.json`.
Сколько инструментов у Envoy?
Семьдесят: они создают, соединяют, настраивают и отлаживают операторы в живой сети.
Что такое TDXN?
Формат, в который сеть TouchDesigner выгружается как читаемый YAML-файл. Из него агент видит содержимое экрана, из него можно сравнить версии и восстановить сеть.
Что делает Convoy?
Convoy-узлы Embody в доверенной локальной сети обнаруживают друг друга, и одна сессия агента запускает на других машинах сборки, тесты, сохранения и перезапуски.
Нужна ли настройка Python?
Нет, Embody сам строит окружение `.venv` под интерпретатор TouchDesigner, а свои пакеты можно ставить в него же.
Обсуждение
Вопросов и отзывов пока нет.
Похожие
MCP-серверыMCP-сервер для TouchDesigner: агент создает и меняет узлы, читает параметры и выполняет Python-скрипты прямо в проекте
tdmcp строит сети узлов TouchDesigner по описанию на обычном языке и сам проверяет результат и показывает превью
Видеоредактор с локальным MCP-сервером: агент проверяет монтаж, правит таймлайн и запускает экспорт, а генерацию отдает ComfyUI
MCP-сервер для Excalidraw: агент рисует диаграмму, добавляет анимацию по ключевым кадрам, а вы смотрите сборку вживую в браузере
MCP-сервер и панель управляют проектом Adobe After Effects: агент читает композицию и собирает анимацию как обычные слои и ключи.
MCP-сервер для Ableton Live: агент создает дорожки, расставляет клипы и собирает аранжировку прямо в открытом проекте
Коротко о README
Текст описывает четыре части: Envoy, Embody, Convoy и TDXN. Затем идут быстрый старт, раздел про MCP-сервер Envoy, документация и сведения об обновлении.