touchdesigner-mcp-server

touchdesigner-mcp-server

8beeeaaatMIT
348 звёзд31 форков
TouchDesigner MCP — это мост между AI-агентами и средой визуального программирования TouchDesigner. Сервер работает по протоколу MCP и взаимодействует с нодом WebServer DAT. Вместо ручных операций вы отдаёте текстовые команды ассистенту, а тот выполняет их в проекте. Инструмент рассчитан на VJ-художников, моушен-дизайнеров и разработчиков интерактивных инсталляций. Он ускоряет прототипирование, автоматизирует рутину и упрощает работу с Python API TouchDesigner.
Ai-ml
Открыть на GitHub

Установка

npx -y touchdesigner-mcp-server

Характеристики

Общее

  • СтатусСообщество
  • Разработчик8beeeaaat
  • ЛицензияMIT

Технологии

  • Языки
    TypeScript
  • Транспорт
    stdio

Описание

Возможности

  • Создавать новые ноды в проекте — любой тип из перечня TouchDesigner.
  • Удалять существующие ноды по указанному пути.
  • Выполнять произвольные Python-скрипты непосредственно в рантайме TouchDesigner.
  • Вызывать методы конкретных нодов через Python-код.
  • Читать и изменять параметры любого нода (TOP, CHOP, SOP, DAT, COMP и другие).
  • Искать ноды по родительскому пути с фильтрацией по типу, имени или тегу.
  • Проверять проект на ошибки: собирать диагностику для указанного нода и его дочерних элементов.
  • Запрашивать справку (help()) по модулям и классам Python TouchDesigner.
  • Получать детальную информацию о классах и модулях — вплоть до списка методов и атрибутов.
  • Выводить базовую информацию о серверном окружении TouchDesigner.

Как подключить

Установка выполняется через Node.js. Вам не придётся разворачивать отдельный сервер — достаточно команды NPX.

  1. Убедитесь, что Node.js установлен. Запустите установку: npx -y touchdesigner-mcp-server
  2. В TouchDesigner создайте нод WebServer DAT и настройте его на приём команд (стандартный порт — 8080).
  3. Откройте конфигурационный файл вашего MCP-клиента. Для Claude Desktop это claude_desktop_config.json:
{ "mcpServers": { "touchdesigner": { "command": "npx", "args": ["-y", "touchdesigner-mcp-server"], "env": { "TD_WEBSERVER_PORT": "8080" } } } }

Сохраните файл и полностью перезапустите клиент. После этого ассистент сможет выполнять команды в вашем проекте.

Примеры запросов

  • «Создай нод Constant, переименуй его в “myColor”, установи цвет на ярко-синий и подключи к Null1.»
  • «Найди в папке /project1 все ноды типа Movie File In TOP и выведи их пути.»
  • «Выполни Python-скрипт: для всех нодов Geo COMP в /geo/ установи параметр Display в True.»
  • «Проверь проект /main на ошибки. Если есть — исправь параметр Cycle на нодах Ramp TOP на значение 1.»
  • «Покажи подробную информацию о классе baseCOMP из Python API TouchDesigner.»

Технические детали

  • Язык реализации: TypeScript
  • Транспортный протокол: stdio
  • Лицензия: MIT
  • Технология: Node.js
  • Совместимые клиенты: Claude Desktop, VS Code (расширения Cline, Continue), любые MCP-клиенты с поддержкой stdio.

Поделиться