作者 8beeeaaat · 8beeeaaat/touchdesigner-mcp
AI原生TouchDesigner控件—代理通过本地WebServer DAT桥创建节点、调整参数、运行Python和读取错误。
touchdesigner-mcp允许代理在MCP上操作正在运行的TouchDesigner项目。12个工具涵盖了要点：列出/创建/删除节点、设置参数、在TouchDesigner中运行任意Python以及自省环境（类目录、节点错误、模块帮助）。TouchDesigner内部的WebServer DAT （来自mcp_webserver_base.tox ， API ≥ 1.3.0 ）侦听端口9981 ； MCP服务器通过HTTP与其通话。 针对想要在TouchDesigner中使用人工智能配对编程的运动设计师、现场视觉艺术家和装置工程师。
%APPDATA%\Claude\claude_desktop_config.json{
"mcpServers": {
"touchdesigner-mcp": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
],
"env": {
"TD_WEBSERVER_HOST": "127.0.0.1",
"TD_WEBSERVER_PORT": "9981"
}
}
}
}打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。
{
"mcpServers": {
"touchdesigner-mcp": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
],
"env": {
"TD_WEBSERVER_HOST": "127.0.0.1",
"TD_WEBSERVER_PORT": "9981"
}
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"touchdesigner-mcp": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
],
"env": {
"TD_WEBSERVER_HOST": "127.0.0.1",
"TD_WEBSERVER_PORT": "9981"
}
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"touchdesigner-mcp": {
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
],
"env": {
"TD_WEBSERVER_HOST": "127.0.0.1",
"TD_WEBSERVER_PORT": "9981"
}
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "touchdesigner-mcp",
"command": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"context_servers": {
"touchdesigner-mcp": {
"command": {
"path": "npx",
"args": [
"-y",
"touchdesigner-mcp-server"
]
}
}
}
}加入 context_servers。Zed 保存后热重载。
claude mcp add touchdesigner-mcp -- npx -y touchdesigner-mcp-server一行命令搞定。用 claude mcp list 验证，claude mcp remove 卸载。
何时使用： 您正在开始一个新的补丁，并希望在手动调整之前将骨架就位。
结果： 您可以调整工作的启动补丁，而不是从头开始拖动。
何时使用： 您想在不点击TD UI的情况下探索参数范围。
结果： 更快的迭代；无聊的组合点击工作消失了。
何时使用： 您正在编写脚本CHOP/DAT ，需要知道调用哪种方法。
结果： 基于实时TouchDesigner实例的准确Python示例。
将快照/渲染保存到磁盘，并在下一回合引用它们
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| create_td_node | parent_path, type, name? | 添加新运算符 | 0 |
| delete_td_node | path | 移除操作员 | 0 |
| update_td_node_parameters | path, params map | 在节点上设置一个或多个参数 | 0 |
| get_td_nodes | filter? | 枚举与筛选器匹配的节点 | 0 |
| get_td_node_parameters | path | 读取当前参数值 | 0 |
| get_td_node_errors | (none) | 查找并修复当前项目中的问题 | 0 |
| execute_python_script | script: str | 逃脱其他工具无法覆盖的任何东西的舱口 | 0 |
| exec_node_method | path, method, args | 调用节点上的特定方法（例如.cook () ） | 0 |
| get_td_classes | (none) | 列出可供选择的课程 | 0 |
| get_td_class_details | class_name | 真实API表面中的Ground Python建议 | 0 |
| get_module_help | module_name | 检索模块文档字符串 | 0 |
| get_td_info | (none) | 检查TD版本和服务器状态 | 0 |
ECONNREFUSED 127.0.0.1: 9981TouchDesigner未运行或WebServer DAT未处于活动状态。打开毒性物质并确认其处于活动状态。
In TD console: op('mcpwebserver').par.active.eval()API版本太低将TouchDesigner升级到API ≥ 1.3.0的版本。
Help → About TouchDesignerPython执行静默失败检查TD文本端口的溯源；有些操作仅在连接到查看器时才会进行。
Alt-T opens the textport| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| unreal | 您正在驱动虚幻引擎场景，而不是TouchDesigner补丁 | 不同的运行时；不同的DCC |
| unity | Unity是您的目标引擎 | 完全不同的DCC |
| godot-mcp-pro-2 | Godot是你的引擎 | 不同的DCC |