touchdesigner-mcp-server — MCP-сервер для Claude Code: настройка
MCP-сервер связывает ИИ-агента с TouchDesigner через WebServer DAT. Позволяет создавать ноды, менять параметры и запускать Python-скрипты прямо из чата.
claude mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-serverЧто делает touchdesigner-mcp-server
Сервер работает как мост между контекстом модели и компонентом mcp_webserver_base.tox внутри TouchDesigner. Через набор инструментов агент считывает дерево проекта, создаёт и удаляет ноды, правит их параметры и забирает готовые кадры с нод TOP. Если стандартных действий не хватает, сервер выполняет произвольный Python-скрипт или вызывает методы конкретных нод.
Инструмент get_td_node_errors проверяет ошибки и предупреждения в дереве компонентов, выявляя потерянные ссылки на файлы или сбои шейдеров. Совместимость завязана на версию API внутри компонента .tox (требуется версия не ниже 1.3.0), а не на номер пакета в npm. Без запущенного TouchDesigner с активным WebServer DAT запросы завершаются ошибкой ECONNREFUSED, причём сервер кэширует неудачное соединение на 60 секунд перед повторной попыткой.
Какие задачи решает
- управлять нодами и параметрами TouchDesigner через чат
- находить предупреждения и ошибки шейдеров в дереве проекта
- выполнять Python-скрипты внутри запущенного TouchDesigner
- передавать текущее изображение с TOP-ноды агенту
Примеры запросов агенту
- Создай ноду
moviefileinв контейнере/project1и укажи путь к видео - Проверь ошибки и предупреждения у ноды
/project1/geo1 - Сделай снимок с ноды
/project1/out1и покажи результат
Как установить touchdesigner-mcp-server
Командой платформы
claude mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-serverКомандой платформы
codex mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-serverФайл настроек
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
]
}
}
}Файл настроек
{
"servers": {
"touchdesigner-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
]
}
}
}Командой платформы
gemini mcp add touchdesigner-mcp-server npx -y touchdesigner-mcp-serverПо шагам, с командами для каждой платформы: Как подключить MCP-сервер: Claude Code, Codex, Cursor, VS Code, Gemini CLI и другие
Вопросы о touchdesigner-mcp-server
Как установить touchdesigner-mcp-server в Claude Code?
Выполните команду claude mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-server.
Что делает touchdesigner-mcp-server?
Он даёт ИИ-ассистентам доступ к управлению проектом TouchDesigner в реальном времени. Модель может менять параметры нод, выполнять Python-код и проверять диагностику дерева компонентов.
Что нужно настроить в TouchDesigner для подключения?
В проект нужно добавить компонент mcp_webserver_base.tox и держать TouchDesigner запущенным. Для работы требуется версия API компонента не ниже 1.3.0.
