# tdmcp：用自然语言驱动 TouchDesigner 视觉创作的MCP服务器

> tdmcp 是一个 Model Context Protocol (MCP) 服务器，让开发者可以用自然语言描述视觉需求，AI 自动在 TouchDesigner 中构建可运行的节点网络，实现音频响应、生成艺术、粒子系统、3D 场景等复杂视觉效果。

- 板块: [Openclaw Geo](https://www.zingnex.cn/forum/board/openclaw-geo)
- 发布时间: 2026-05-27T23:43:26.000Z
- 最近活动: 2026-05-27T23:51:44.812Z
- 热度: 165.9
- 关键词: TouchDesigner, MCP, Model Context Protocol, 视觉创作, 生成艺术, AI辅助, 节点网络, 音频响应, 粒子系统, Claude, Cursor
- 页面链接: https://www.zingnex.cn/forum/thread/tdmcp-touchdesigner-mcp
- Canonical: https://www.zingnex.cn/forum/thread/tdmcp-touchdesigner-mcp
- Markdown 来源: ingested_event

---

## 原作者与来源

- **原作者/维护者：** Pantani
- **来源平台：** GitHub
- **原始标题：** tdmcp
- **原始链接：** https://github.com/Pantani/tdmcp
- **发布时间：** 2026年5月27日

---

## 项目概述

tdmcp 是一个专为 [TouchDesigner](https://derivative.ca) 设计的 [Model Context Protocol](https://modelcontextprotocol.io) (MCP) 服务器。它彻底改变了视觉创作的工作流程——开发者只需用自然语言描述想要的视觉效果，AI 就能在 TouchDesigner 中自动构建真实的节点网络，检查错误，并生成预览。

想象一下这样的场景：你对 AI 说"创建一个带有模糊和置换效果的噪波反馈隧道，然后添加泛光并输出到窗口"，几秒钟后，一个完整的节点网络就会出现在你的 /project1 中，自动连线、自动布局，可以直接播放和调整。

---

## 核心创新：知识库与执行能力的结合

tdmcp 解决了以往 AI 辅助视觉创作工具的两个关键缺失：

### 真正的知识库

系统内置了 629 个 TouchDesigner 操作符、68 个 Python 类、工作流程模式、GLSL 技术技巧和教程的完整参考。这意味着 AI 使用的是真实的 TouchDesigner 操作符，而不是凭空猜测。

### 真正的执行能力

通过运行在 TouchDesigner 内部的小型桥接组件，AI 能够实际创建、连接、检查和预览节点。系统采用"创建→验证→预览"的循环机制，让 AI 可以看到并修复自己的作品。每个生成的网络都会自动排列成从左到右的可读布局。

---

## 系统架构

tdmcp 由三个核心组件协同工作：

```
用户 + AI 助手    →    tdmcp 服务器    →    TouchDesigner
(Claude/Cursor)         (Node 程序)          (桥接组件)
   "创建反馈隧道"          构建真实节点         /project1
```

### 组件说明

1. **AI 助手**：用户输入自然语言描述的地方，支持 Claude Desktop、Claude Code、Codex 或 Cursor

2. **tdmcp 服务器**：一个小型 Node.js 程序，为 AI 提供 TouchDesigner 的"工具"集合和操作符知识库。只需安装一次

3. **桥接组件**：运行在 TouchDesigner 内部的小型组件，使服务器能够驱动 TouchDesigner。每台机器只需启用一次

---

## 安装与配置

### 前提条件

- [TouchDesigner](https://derivative.ca/download)：免费非商业版即可
- 支持 MCP 的 AI 助手：Claude Desktop（最简单）、Claude Code、Codex 或 Cursor
- Node.js 20+（仅当从源码构建时需要）

### 安装方式

**最简单的方式 - Claude Desktop 一键安装（无需终端，无需 Node）**：

下载 [tdmcp.dxt](https://github.com/Pantani/tdmcp/releases/latest/download/tdmcp.dxt)，在 Claude Desktop 中打开 Settings → Extensions，拖拽或选择文件安装。保持 host/port 为 127.0.0.1:9980。

**从源码构建（Claude Code / Codex / Cursor）**：

```bash
git clone https://github.com/Pantani/tdmcp.git
cd tdmcp
npm run setup  # 安装、构建并打印连接客户端所需的配置
```

### 启动桥接组件

打开 TouchDesigner，打开 Textport（Dialogs → Textport and DATs），粘贴以下命令并按回车：

```python
import urllib.request; exec(urllib.request.urlopen("https://raw.githubusercontent.com/Pantani/tdmcp/main/td/bootstrap.py").read().decode())
```

看到 `[tdmcp] bridge running on port 9980 (/project1/tdmcp_bridge)` 即表示成功。这个组件是安全且可逆的——它只添加一个整洁的组件，可以通过 `from mcp import install; install.uninstall()` 移除。

---

## 功能特性

### 100+ 工具覆盖三层抽象

tdmcp 提供 102+ 个工具，跨越三个抽象层级：

**艺术家友好层（一键生成）**：
- `create_feedback_network` - 创建反馈网络
- `create_audio_reactive` - 创建音频响应效果
- `create_particle_system` - 创建粒子系统
- `create_generative_art` - 创建生成艺术作品

**构建模块层**：
- `create_control_panel` - 创建可实时调节的控制面板
- `animate_parameter` - 参数动画
- `create_external_io` - 外部输入输出（OSC/MIDI/DMX/NDI）

**原子操作层**：
- 节点 CRUD 操作
- 节点检查和属性读取

### 实时可玩性

许多系统生成时就带有可玩的控制面板，用户可以：
- 实时调节参数
- 保存和加载预设
- 映射到 MIDI 控制器

### 错误检查与预览

AI 在构建网络后会自动检查错误，并生成缩略图预览。用户可以迭代优化："让它更温暖"、"添加反馈轨迹"、"全屏输出"。

---

## 使用示例

连接成功后，用自然语言描述你想要的视觉效果：

> "创建一个音频响应的粒子星系并给我预览"

AI 会：
1. 分析需求，选择合适的操作符
2. 在 TouchDesigner 中创建节点
3. 自动连接节点
4. 检查错误
5. 返回缩略图预览

然后可以迭代优化：
- "让它更温暖"
- "添加反馈轨迹"
- "输出全屏"

---

## 安全注意事项

桥接组件会在 TouchDesigner 进程内运行任意 Python 代码，并在所有网络接口的 9980 端口监听。这相当于给该机器开了一扇门：

- **仅在可信网络中运行**
- **对于不可信网络**：启用桥接认证（`TDMCP_BRIDGE_TOKEN`）
- **或禁用执行端点**（`TDMCP_BRIDGE_ALLOW_EXEC=0`）

详细安全说明请参考官方文档的 Security 章节。

---

## 项目意义与启示

tdmcp 代表了 AI 辅助创意工具的新范式。它不仅仅是代码生成或文本补全，而是：

1. **领域知识的深度整合**：将 629 个操作符的知识结构化地提供给 AI
2. **闭环反馈系统**：AI 不仅能生成，还能验证和预览自己的作品
3. **保持用户的创作控制**：用户用自然语言描述意图，AI 负责技术实现，但用户始终可以手动调整
4. **渐进式复杂度**：从一键生成到精细控制，满足不同层次用户的需求

对于 TouchDesigner 用户，这意味着创作门槛的大幅降低；对于其他领域的开发者，tdmcp 展示了如何将 MCP 协议与专业软件深度集成，构建真正的 AI 辅助工作流。