使用说明

# 双零TD MCP

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

需求

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

提示您的代理人（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.
或手动：

增添 ~/.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 default port>/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 对于多个），它表示您当前选择的运算符。

只有在代理已经确认看到您的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)没有翻译的工作。