# TouchDesigner MCP

通过标准 MCP Server 控制正在运行的 TouchDesigner。TD 端使用可拖入的 .tox 组件提供本地 HTTP 桥接，MCP Server 通过 stdio 对外暴露工具。

内容

• outputs/TD_MCP_Bridge.tox：TouchDesigner 组件，拖入 TD 即可使用。

• src/：标准 MCP Server 源码。

• touchdesigner/install_td_mcp.py：开发/重建 .tox 用的 TD 安装脚本。

使用 TouchDesigner 组件

1. 打开目标 .toe。

2. 将 outputs/TD_MCP_Bridge.tox 拖入 TouchDesigner 网络编辑区。

3. 选中 TD_MCP_Bridge 组件。

4. 在 MCP 参数页设置：

   • 端口：默认 9980

   • 访问令牌：请自行设置，不要公开

   • 服务开关：打开后启动 Web Server DAT

5. 连接地址通常是：

http://127.0.0.1:9980/api

安装 Node.js 依赖

要求 Node.js 20 或更高版本：

npm install
npm run build

MCP Client 配置示例

把 <项目目录> 替换为你本机 clone 后的目录，把 <访问令牌> 替换为 TD 组件 MCP 参数页里的访问令牌。

{
  "mcpServers": {
    "touchdesigner": {
      "command": "node",
      "args": [
        "<项目目录>/dist/index.js"
      ],
      "env": {
        "TD_MCP_URL": "http://127.0.0.1:9980/api",
        "TD_MCP_TOKEN": "<访问令牌>",
        "TD_MCP_TIMEOUT_MS": "10000"
      }
    }
  }
}

可用能力

• td_ping

• td_project_info

• td_list_operators

• td_operator_info

• td_get_parameters

• td_set_parameter

• td_pulse_parameter

• td_create_operator

• td_connect_operators

• td_disconnect_input

• td_set_node_position

• td_get_dat_text

• td_set_dat_text

• td_destroy_operator

• td_save_project

• td_execute_python

安全说明

• 不要提交 .env 或真实访问令牌。

• 默认只建议绑定本机 127.0.0.1 使用，不要把端口暴露到公网。

• td_execute_python 默认关闭；确有需要时，在 TD 组件的 MCP 参数页手动开启 允许任意 Python。

• td_destroy_operator 需要显式传入 confirm=true，并且桥接组件与工程根节点受保护。

验证

npm test