SuperAPI AI 工具集

touchdesigner-mcp

设计与创作

查看项目

更新于 10-16 07:24

技能介绍

用途:让 Hermes 智能体通过 twozero MCP 驱动本机运行中的 TouchDesigner,创建算子、设置参数、连线、执行 Python 并构建实时视觉。架构为 Hermes Agent → MCP(Streamable HTTP)→ twozero.tox(端口 40404)→ TD Python。

主要能力:提供 36 个原生工具,覆盖核心操作(td_execute_python、td_create_operator、td_set_operator_pars、td_get_operator_info、td_get_network、td_get_errors、td_get_par_info、td_get_hints、td_get_focus)、读写(td_read_dat、td_write_dat、td_read_chop、td_read_textport)、视觉(td_get_screenshot、td_get_screenshots、td_navigate_to)、搜索(td_find_op、td_search)、系统(td_get_perf、td_list_instances、td_get_docs、td_reinit_extension)等。具备上下文感知,可识别当前选中算子与网络;健康检查 GET http://localhost:40404/mcp 返回实例 PID、项目名与 TD 版本。

使用方式:从 Nous 插件目录安装并启用插件:hermes plugins install touchdesigner 与 hermes plugins enable td,启用后自动注册 MCP 服务器。可选脚本 bash "${HERMES_SKILL_DIR}/scripts/setup.sh" 检查 TD、下载 twozero.tox 并做端口健康检查。手动步骤:将 twozero.tox 拖入 TD 网络编辑器并点击 Install;在 twozero 图标 → Settings → mcp 中开启 auto start MCP;重启 Hermes 会话。验证:nc -z 127.0.0.1 40404 && echo "twozero MCP: READY"。

限制:TouchDesigner 仅支持 Windows 与 macOS,无 Linux 版本;twozero 默认绑定 localhost,跨机需端口转发。MCP 仅监听本地且无认证,td_execute_python 拥有 TD 进程用户的完整 Python 与文件系统权限。非商业版分辨率上限 1280×1280,H.264/H.265/AV1 需商业许可。设置参数前必须先调用 td_get_par_info,勿猜测参数名。桌面输入自动化与 admin/dev 工具默认不启用,仅在用户明确要求时使用。