TouchDesigner MCP
MCP-сервер для TouchDesigner: агент создает и меняет узлы, читает параметры и выполняет Python-скрипты прямо в проекте
Средний риск
Средний уровень ставим, когда инструмент запускает код, ходит в сеть или читает файлы проекта. Перед установкой посмотрите, что именно он делает.
Почему такой уровень
- Выполняет произвольные Python-скрипты в TouchDesigner
- Создает, меняет и удаляет узлы в вашем проекте
Установка
В терминале, через SkillFoxx CLI
npx skillfoxx add mcp/touchdesigner-mcpОпределит агенты на машине, проверит риск и зафиксирует версию.
Другие способы установки
Выполните в терминале
claude mcp add --transport stdio touchdesigner-mcp-server -- npx -y touchdesigner-mcp-server@2.1.0Или добавьте в файл .mcp.json, в проекте
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Добавьте в файл ~/.cursor/mcp.json, для всех проектов
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Для одного проекта тот же блок кладут в .cursor/mcp.json.
Кнопка откроет агент и предложит добавить сервер. Если ничего не произошло, скопируйте конфиг ниже.
Выполните в терминале
code --add-mcp '{"name":"touchdesigner-mcp-server","type":"stdio","command":"npx","args":["-y","touchdesigner-mcp-server@2.1.0"]}'Или добавьте в файл .vscode/mcp.json, в проекте
{
"servers": {
"touchdesigner-mcp-server": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа servers.
Выполните в терминале
codex mcp add touchdesigner-mcp-server -- npx -y touchdesigner-mcp-server@2.1.0Или добавьте в файл ~/.codex/config.toml, для всех проектов
[mcp_servers.touchdesigner-mcp-server]
command = "npx"
args = ["-y", "touchdesigner-mcp-server@2.1.0"]Если файл уже есть, допишите блок в конец.
Добавьте в файл ~/.gemini/settings.json, для всех проектов
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Добавьте в файл ~/.config/devin/mcp_config.json, для всех проектов
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. В легаси Cascade конфиг MCP лежит в ~/.codeium/windsurf/mcp_config.json.
Бывший Windsurf.
Добавьте в файл cline_mcp_settings.json, для всех проектов
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers. Файл настроек открывается в Cline: вкладка MCP Servers, кнопка Configure MCP Servers.
Добавьте в файл .roo/mcp.json, в проекте
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Форк Roo Code, папки .roo те же.
Добавьте в файл opencode.json, в проекте
{
"mcp": {
"touchdesigner-mcp-server": {
"type": "local",
"command": [
"npx",
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcp.
Добавьте в файл ~/.config/zed/settings.json, для всех проектов
{
"context_servers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа context_servers.
Добавьте в файл .codeassistant/mcp.json, в проекте
{
"mcpServers": {
"touchdesigner-mcp-server": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server@2.1.0"
]
}
}
}Если файл уже есть, добавьте сервер внутрь ключа mcpServers.
Импортируй компонент mcp_webserver_base.tox в проект TouchDesigner, затем добавь сервер: claude mcp add -s user touchdesigner -- npx -y touchdesigner-mcp-server@latest.
Другие способы из описания автора
claude mcp add -s user touchdesigner -- npx -y touchdesigner-mcp-server@latestСначала импортируйте компонент mcp_webserver_base.tox в проект TouchDesigner.
Это чужой код. Посмотрите файлы в репозитории перед установкой.
Что делает
Сервер соединяет ИИ-агента с TouchDesigner через компонент WebServer DAT и дает управлять проектом на лету. Агент создает, меняет и удаляет узлы, читает структуру проекта и параметры, запускает произвольные Python-скрипты и вызывает методы узлов. Есть инструменты для проверки ошибок и предупреждений по узлу и его потомкам, получения списков и деталей классов Python в TouchDesigner и захвата вывода TOP-узла в картинку. Готовые подсказки помогают искать узлы, соединять их и проверять ошибки. Связь идет по WebSocket в реальном времени, без опроса файлов. Сервер работает с Claude Code, Claude Desktop, Cursor и Codex.
Для кого. Для художников по визуалу и разработчиков на TouchDesigner, которым нужна работа с проектом через агента.
Подходит, если
- Нужно создавать и менять узлы в проекте TouchDesigner через агента
- Нужно выполнить Python-скрипт прямо в проекте
- Нужно проверить ошибки и предупреждения по узлам сцены
Не подходит, если
- Нельзя выполнять произвольный Python в проекте
- TouchDesigner не запущен и компонент WebServer DAT не подключен
Пример запроса к агенту
Создай узел частиц в TouchDesigner и покажи ошибки по сценеОграничения
Нужен запущенный TouchDesigner с импортированным компонентом mcp_webserver_base.tox, по умолчанию порт 9981. Сервер и компонент сверяются по версии API, при несовпадении крупных версий работа останавливается с просьбой обновить. Инструмент execute_python_script выполняет произвольный Python в проекте, применяйте осознанно. Установка идет через npx или Docker.
Как отключить. Удалите запись touchdesigner из конфигурации MCP агента и уберите компонент WebServer из проекта TouchDesigner.
MCP
- Транспорт
- stdio, http
- Авторизация
- не нужна
Проверка безопасности
- Выполняет произвольные Python-скрипты в TouchDesigner
- Создает, меняет и удаляет узлы в вашем проекте
Коротко о README
README описывает TouchDesigner MCP как сервер, который дает агентам управлять проектами TouchDesigner через компонент WebServer DAT. Доступны инструменты создания, изменения и удаления узлов, чтения параметров и структуры, выполнения Python и захвата вывода TOP в картинку, плюс готовые подсказки для поиска и соединения узлов. Связь идет по WebSocket в реальном времени. Ставится через npx командами claude mcp add или codex mcp add, есть вариант с Docker и рекомендованный плагин. Версии сервера и компонента сверяются по API. Лицензия MIT.
Частые вопросы
Что нужно на стороне TouchDesigner?
Запущенный TouchDesigner с импортированным компонентом mcp_webserver_base.tox и включенным WebServer DAT, по умолчанию порт 9981.
Почему появляется просьба обновить?
Сервер и компонент имеют независимые версии API; при устаревшем или слишком новом компоненте сервер предупреждает или останавливает работу до обновления.
Похожие
Скиллы и CLI от HeyGen: агент пишет HTML-композиции и рендерит из них MP4-ролики, субтитры, моушн-графику и слайды
Blender MCP
MCP for Blender
MCP-сервер и аддон для Blender: агент создает и меняет объекты, материалы и сцены, подгружает ассеты и выполняет Python в Blender
Скиллы Remotion
Remotion Agent Skills
Официальные скиллы Remotion для создания видео на React: композиции, анимации, субтитры, карты и рендер
Агентная видеостудия для Claude Code, Cursor и Codex: сценарий, озвучка, картинки, стоковые кадры, музыка, субтитры и рендер