TouchDesigner 控制

通过 twozero MCP 控制运行中的 TouchDesigner 实例。

关键规则

• 绝不猜测参数名。先为 op 类型调用 td_get_par_info。
• 如果 tdAttributeError 触发，停止。在继续之前对失败的节点调用 td_get_operator_info。
• 绝不在脚本回调中硬编码绝对路径。使用 me.parent() / scriptOp.parent()。
• 优先使用原生 MCP 工具而非 td_execute_python。使用 td_create_operator、td_set_operator_pars、td_get_errors 等。
• 构建前调用 td_get_hints。它返回你正在使用的 op 类型特定的模式。

架构说明

Hermes Agent -> MCP (Streamable HTTP) -> twozero.tox (port 40404) -> TD Python

36 个原生工具。免费插件（无付费/许可证）。

上下文感知（知道选中的 OP、当前网络）。

安装配置（自动化）

运行设置脚本处理所有内容：

bash "${HERMES_HOME:-$HOME/.hermes}/skills/creative/touchdesigner-mcp/scripts/setup.sh"

手动步骤（一次性）

• 将 ~/Downloads/twozero.tox 拖入 TD 网络编辑器 → 点击 Install
• 启用 MCP：点击 twozero 图标 → Settings → mcp → "auto start MCP" → Yes
• 重启 Hermes 会话以拾取新的 MCP 服务器

环境要求

• 非商业 TD分辨率上限为 1280×1280。使用 outputresolution = 'custom' 并明确设置 width/height。
• 编解码器：prores（macOS 上首选）或 mjpa 作为后备。H.264/H.265/AV1 需要商业许可证。
• 设置参数前始终调用 td_get_par_info——名称因 TD 版本而异。

工作流程

步骤 0：发现（构建任何东西之前）

Call td_get_par_info with op_type for each type you plan to use.
Call td_get_hints with the topic you're building.
Call td_get_focus to see where the user is and what's selected.
Call td_get_network to see what already exists.

步骤 1：清理 + 构建

重要：将清理和创建分成单独的 MCP 调用。

为每个节点使用 td_create_operator：

td_create_operator(type="noiseTOP", parent="/project1", name="bg", parameters={"resolutionw": 1280, "resolutionh": 720})
td_create_operator(type="levelTOP", parent="/project1", name="brightness")
td_create_operator(type="nullTOP", parent="/project1", name="out")

步骤 2：设置参数

td_set_operator_pars(path="/project1/bg", parameters={"roughness": 0.6, "monochrome": true})

步骤 3：连线

使用 td_execute_python——无原生连线工具：

op('/project1/bg').outputConnectors[0].connect(op('/project1/fx').inputConnectors[0])

步骤 4：验证

td_get_errors(path="/project1", recursive=true)
td_get_perf()
td_get_operator_info(path="/project1/out", detail="full")

步骤 5：显示/捕获

td_get_screenshot(path="/project1/out")

MCP 工具快速参考

核心（最常用）：

视觉：

音频响应式 GLSL（经验证配方）

正确信号链

AudioFileIn CHOP (playmode=sequential)
  → AudioSpectrum CHOP (FFT=512, outputmenu=setmanually, outlength=256, timeslice=ON)
  → Math CHOP (gain=10)
  → CHOP to TOP (dataformat=r, layout=rowscropped)
  → GLSL TOP input 1 (spectrum texture, 256x2)

关键音频响应规则

• AudioSpectrum 的 TimeSlice 必须保持开启。关闭 = 处理整个音频文件 → 溢出。
• 手动设置 Output Length 为 256。
• 不要使用 Lag CHOP 进行频谱平滑。在 GLSL 着色器中完成。
• CHOP to TOP dataformat = 'r'，layout = 'rowscropped'。

Operator 快速参考

安全说明

• MCP 仅在 localhost 运行（端口 40404）。无认证。
• td_execute_python 可无限制访问 TD Python 环境和文件系统。
• 此 skill 从不向 localhost 外发送数据。所有 MCP 通信都是本地的。