AI导哈

TouchDesigner MCP服务器

一个运行在TouchDesigner中的MCP服务器，允许AI代理通过Python执行、操作符检查、DAT读写和视觉输出捕获完全控制项目。

  • by johnsabath
  • Python
  • 云端部署
  • 16 星标
  • 更新于
在 GitHub 查看 johnsabath/touchdesigner-mcp

使用说明

TouchDesigner MCP服务器

一 主控程序 在TouchDesigner内部运行的服务器，使AI代理能够完全控制您的项目——执行Python、检查运算符、读/写DAT和捕获视觉输出。

由Claude Code与Opus 4.6使用此MCP服务器构建

快速开始

  1. 拖拽 td_mcp_server.tox 进入您的项目--服务器在端口上启动 9988
  2. 将您的MCP客户端指向 http://localhost:9988/mcp
  3. 开始构建

这 .tox 是自包含的——没有要配置的文件路径。

MCP客户端设置： 克劳德代码 · 光标 · 帆板运动

手动设置

如果您不想使用 .tox:

  1. 创建Web服务器DAT，将端口设置为 9988，启用Active
  2. 使用以下内容创建TextDAT scripts/td_mcp_server.py
  3. 将Web服务器DAT的回调设置为指向您的TextDAT

工具

工具 说明
run 执行Python代码——表达式直接返回值，多行代码捕获stdout
inspect 详细的操作员信息——通道、参数、错误、连接
set 使用验证设置运算符参数——常量值和/或表达式
create 在一次调用中创建一个包含位置、参数、表达式和接线的运算符（需要 nodeX/nodeY)
wire 具有自动递增输入索引的批处理接线运算符连接和参数表达式
read 读取TextDAT（带可选偏移/限制）
write 覆盖TextDAT（如果缺少则创建）
edit 在TextDAT中查找/替换
list 在容器下列出运算符，可按族/模式筛选
docs 查找任何操作类型的参数、菜单、默认值和连接器
observe 捕获当前视觉输出的快照（PNG）或动画GIF
render 使用TD原生录制渲染MP4视频——支持音频捕获、自动或手动启动/停止
map 将操作员网络渲染为具有连接、位置和非默认参数的文本映射

network_map 例子

三个示例项目的输出(完整来源):

digraph network {
    rankdir=LR;
    ...
    glsl_main -> out;
    fb_seed -> fb_comp -> fb_hsv -> fb_level -> fb_out;
    fb_level -> fb_feedback [style=dashed label="feedback"];
    fb_feedback -> fb_transform -> fb_comp;
    pf_lfo1 -> pf_merge; pf_lfo2 -> pf_merge; pf_noise_chop -> pf_merge;
    pf_glsl -> pf_out;
}

克劳德代码技能

此回购包括 Claude代码技能 在 .claude/skills/touchdesigner-building/ 它教代理如何有效地使用MCP工具——正确的参数名称、GLSL工作流程、反馈回路接线、迭代观察回路和常见的调试步骤。

Claude Code在检测到相关任务（创建运算符、编写着色器、设置参数等）时会自动加载技能。如果您已经在使用此仓库，则不需要手动设置。

在不同的项目中使用该技能，复制 .claude/skills/touchdesigner-building/ 目录到项目的 .claude/skills/ 文件夹，并确保 .mcp.json 指向正在运行的MCP服务器。

运作原理

实现 MCP流式HTTP （基于POST的JSON-RPC）在Web服务器DAT上。没有外部依赖关系。根运算符是通过以下方式自动发现的 me.parent().

需求

  • 触摸设计师2024+
  • 任何兼容MCP的客户端

许可证

麻省理工学院

相关 MCP