TouchDesigner MCP MCP — Сценарии использования, Установка & Живое демо

Зачем использовать

Ключевые функции

12 инструментов: создание/удаление узла, установка параметров, запуск Python, чтение ошибок, самоанализ класса/модуля.
Работает через DAT веб-сервера в TouchDesigner (в комплекте .tox).
Настраиваемый порт (по умолчанию 9981), по умолчанию только локальный хост.
Выполнение Python позволяет вам достичь всего, что предоставляет TD.
Проверка ошибок помогает агентам быстро исправлять ошибки

Живое демо

Как выглядит на практике

touchdesigner-mcp.replay ▶ готово

0/0

Установка

Выберите клиент

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

Откройте Claude Desktop → Settings → Developer → Edit Config. Перезапустите после сохранения.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

Cursor использует ту же схему mcpServers, что и Claude Desktop. Конфиг проекта приоритетнее глобального.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

Щёлкните значок MCP Servers на боковой панели Cline, затем "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

Тот же формат, что и Claude Desktop. Перезапустите Windsurf для применения.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "touchdesigner-mcp",
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ]
    }
  ]
}

Continue использует массив объектов серверов, а не map.

~/.config/zed/settings.json

{
  "context_servers": {
    "touchdesigner-mcp": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "touchdesigner-mcp-server"
        ]
      }
    }
  }
}

Добавьте в context_servers. Zed перезагружается автоматически.

claude mcp add touchdesigner-mcp -- npx -y touchdesigner-mcp-server

Однострочная команда. Проверить: claude mcp list. Удалить: claude mcp remove.

Сценарии использования

Реальные сценарии: TouchDesigner MCP

Создайте стартовый патч TouchDesigner из краткого описания

👤 Моушн-дизайнеры и визуальные инженеры создают прототипы ⏱ ~30 min intermediate

Когда использовать: Вы запускаете новый патч и хотите, чтобы скелет был на месте перед ручной настройкой.

Предварительные требования

TouchDesigner работает с загруженным mcp_webserver_base.tox — Загрузите токс, зайдите в свой проект, установите порт 9981.
Версия API ≥ 1.3.0 — Проверьте версию TouchDesigner

Поток

Опишите патч

Создайте патч для генеративных визуальных эффектов: аудиореактивные частицы (шум → создание экземпляров), постобработка, вывод 1080p.✓ Скопировано

→ Агент создает связный граф узлов с именованными операторами.
Исправить ошибки

Сообщайте об ошибках TD и исправляйте их.✓ Скопировано

→ Использует get_td_node_errors, исправляет параметры, выполняет итерации

Итог: Работающий стартовый патч, который вы настраиваете, а не перетаскиваете с нуля.

Подводные камни

Агент изобретает несуществующие операторы — Сначала вызовите get_td_classes и придерживайтесь реальных имен классов.

Сочетать с: filesystem

Просмотрите параметры и сравните визуальные результаты

👤 Художники тюнингуют внешний вид ⏱ ~20 min intermediate

Когда использовать: Вы хотите изучить диапазон параметров, не нажимая в пользовательском интерфейсе TD.

Поток

Опишите развертку

Для шума 1 период развертки = 0,2, 0,5, 1,0, 2,0 и гармоники = 1,2,4. Снимок каждого с помощью renderpick1.✓ Скопировано

→ Использует update_td_node_parameters и Execute_python_script для сохранения снимков.
Назовите победителя

Мне понравился период=1,0 гармоники=2. Примените и сохраните проект.✓ Скопировано

→ Параметры установлены, проект сохранен с помощью python exec

Итог: Более быстрая итерация; скучная комбинаторная работа с щелчками исчезла.

Подводные камни

Длинные скрипты Python, блокирующие основной поток TD — Разделите вызовы на короткие периоды или запустите внутри Execute DAT.

Изучите API Python TouchDesigner, обратившись к агенту

👤 Дизайнеры, впервые знакомые с Python TouchDesigner ⏱ ~10 min beginner

Когда использовать: Вы пишете сценарий CHOP/DAT и вам нужно знать, какой метод вызывать.

Поток

Спросить о классе

Какие методы существуют в классе «Оп» для прогулок детей?✓ Скопировано

→ Агент вызывает get_td_class_details и возвращает реальные методы.
Посмотреть работоспособный пример

Покажите короткий фрагмент Python, в котором регистрируется путь каждого потомка.✓ Скопировано

→ Сниппет использует настоящий API, а не выдуманные методы.

Итог: Точные примеры Python, основанные на работающем экземпляре TouchDesigner.

Комбинации

Сочетайте с другими MCP — эффект x10

touchdesigner-mcp + filesystem

Сохраняйте снимки/рендеринги на диск и используйте их на следующем этапе.

После установки каждого параметра сохраните PNG через renderpick1 в ~/td-snapshots/ и прочитайте манифест.✓ Скопировано

touchdesigner-mcp + xcodebuild

Рендеринг и пакет для киоска macOS

Отобразите выходные данные и упакуйте их в пакет приложений macOS с помощью xcodebuild.✓ Скопировано

touchdesigner-mcp + filesystem

Архивный проект представлен как экспорт .toe, отслеживаемый с помощью git.

Экспортируйте текущий проект в формате .toe и зафиксируйте его.✓ Скопировано

Инструменты

Что предоставляет этот MCP

Инструмент	Входные данные	Когда вызывать
create_td_node	parent_path, type, name?	Добавить нового оператора
delete_td_node	path	Удаление оператора
update_td_node_parameters	path, params map	Установите один или несколько параметров на узле
get_td_nodes	filter?	Перечислить узлы, соответствующие фильтру
get_td_node_parameters	path	Чтение текущих значений параметров
get_td_node_errors	(none)	Находите и устраняйте проблемы в текущем проекте
execute_python_script	script: str	Аварийный люк для всего, что не закрывают другие инструменты
exec_node_method	path, method, args	Вызов определенного метода на узле (например, .cook())
get_td_classes	(none)	Список доступных классов на выбор
get_td_class_details	class_name	Обоснование предложений Python на реальной поверхности API
get_module_help	module_name	Получить строки документации модуля
get_td_info	(none)	Проверьте версию TD и состояние сервера

Стоимость и лимиты

Во что обходится

Квота API: Никто
Токенов на вызов: Малый: пути к узлам + небольшие карты параметров.
Деньги: Бесплатно; Действует лицензия TouchDesigner
Совет: Предпочитайте update_td_node_parameters с картой вместо множества вызовов с одним параметром.

Безопасность

Права, секреты, радиус поражения

Хранение учётных данных: Нет учетных данных

Исходящий трафик: HTTP к 127.0.0.1:<порт>. Не размещайте DAT WebServer в общедоступной сети.

execute_python_script запускает произвольный Python внутри вашего процесса TouchDesigner — рассматривайте это как удаленное выполнение кода и используйте только с доверенными подсказками.
Предоставление доступа к DAT WebServer на 0.0.0.0 дает любому пользователю в вашей локальной сети полный контроль над вашим экземпляром TD. Держите его привязанным к 127.0.0.1.

Устранение неполадок

Частые ошибки и исправления

ЭКОННРЕФУСЕД 127.0.0.1:9981

TouchDesigner не запущен или WebServer DAT не активен. Откройте токс и подтвердите, что он активен.

Проверить: In TD console: op('mcpwebserver').par.active.eval()

Версия API слишком низкая

Обновите TouchDesigner до сборки с API версии ≥ 1.3.0.

Проверить: Help → About TouchDesigner

Выполнение Python молча терпит неудачу

Проверьте текстовый порт TD на предмет обратной трассировки; некоторые операторы готовятся только при подключении к средству просмотра.

Проверить: Alt-T opens the textport

Альтернативы

TouchDesigner MCP в сравнении

Альтернатива	Когда использовать	Компромисс
unreal	Вы используете сцены Unreal Engine, а не патчи TouchDesigner.	Разное время выполнения; разные DCC
unity	Unity — ваш целевой движок	Совсем другой DCC
godot-mcp-pro-2	Годо — твой двигатель	Разные DCC

Ещё

Ресурсы

📖 Читать официальный README на GitHub

🐙 Открытые задачи

🔍 Все 400+ MCP-серверов и Skills