Twozero Td MCP

双零TD MCP

用于TouchDesigner的MCP服务器，运行在 twozero插件.

需求

• 触控设计器 2025.32280+
• TD中安装了twozero插件
• 为了获得最佳的TD结果：使用 Claude 4.6+ 或 GPT-5.5+

快速入门

1. 掉落 twozero.tox 进入TouchDesigner： https://www.404zero.com/pisang/twozero.tox ->安装
2. 打开MCP：

Turn on MCP

1. 提示您的代理人（Cursor/Copyro/Claude）：

- Add twozero TD MCP for me with server key "twozero_td" and URL "http://localhost:40404/mcp". Configure it globally (user scope) so it is available from any project/workspace.

1. 或手动：

光标

增添 ~/.cursor/mcp.json:

{
  "mcpServers": {
    "twozero_td": {
      "url": "http://localhost:40404/mcp"
    }
  }
}

重新加载光标窗口。

法典

增添 ~/.codex/config.toml:

[mcp_servers.twozero_td]
url = "http://127.0.0.1:40404/mcp"

重新启动Codex应用程序/会话。

克劳德代码

claude mcp add --transport http --scope user twozero_td http://localhost:40404/mcp

检查：

claude mcp list

备注

• 基本端口由双零设置控制 MCP default port.
• 多实例TD行为是自动的：在客户端中只配置一个MCP URL(http://localhost:/mcp).不要为每个TD实例添加单独的客户端条目；twozero在内部处理额外的实例端口。
• 当同时打开多个TD实例时，代理会列出它们并询问要操作哪个实例——无需手动配置。

使用原则

• 以如下提示开始每次新聊天：

- Show me what you can see in my TD project. - check in TD: [your prompt] - *here in TD: [your prompt] - Check *this op in TD: [your prompt] 这会使代理立即使用MCP，并确认它可以看到您当前的TD上下文（项目、网络、选定的运营商）。

• 之后，直接用正常语言给出任务。
• 当你说 *here in TD，它表示您当前在TD中查看的地点/网络。
• 当你说 *this op in TD （或 *these ops 对于多个），它表示您当前选择的运算符。

任务提示（MCP确认后）

只有在代理已经确认看到您的TouchDesigner上下文后，才能使用这些提示。

• 错误： Check errors across the whole project and show what is critical first.
• 演出 Analyze what is causing lag and show the top slow operators.
• 比较补丁/容器： Compare container A and B: structure, parameters, and connections; list the differences.
• 对选定操作员进行操作： Inspect this selected operator and nearby chain; do not change anything until I confirm.
• 安全模式优先： Diagnostics and plan first, changes only after approval.
• 修复后验证： After applying fixes, run error and performance checks again to verify.

内置触发器

代理识别为内置流的短语：

• *here / *тут （当前网络）和 *this / *эти / *этот / *эту （选定的运算符）--空间标记。星号是神奇的：它从不出现在正常的代码或文本中，因此代理将它们视为明确的指针，响应是坚如磐石的。简单的“here”/“this op”也适用，但星号版本是防弹的——在精度很重要的时候使用它。
• study this project / изучи проект --冷启动补丁分析。最适合不熟悉/大型项目，你想参观，而不是一个专栏。
• twozero bug report / twozero баг репорт --内置的错误报告流。这个词 twozero 是必需的（因此通用的“报告错误”不会意外触发它）。

本地化等效物

自由地与英语混合——代理识别每种语言的这些等价物。TD技术术语(op, par, comp)没有翻译的工作。

俄语

• TouchDesigner = TD = тач
• project = patch = проект = патч = .toe file
• operator = op = оператор = оп
• parameter = par = параметр = пар
• *here in TD = в таче *тут
• *this op in TD = в таче *этот оп
• *these ops in TD = в таче *эти опы
• Show me what you can see in my TD project. = Посмотри, что у меня в таче.