作者 8beeeaaat · 8beeeaaat/touchdesigner-mcp
AI 原生 TouchDesigner 控制項 — 代理程式建立節點、調整參數、執行 Python 並透過本機 WebServer DAT 橋接器讀取錯誤。
touchdesigner-mcp 允許代理程式透過 MCP 操作正在執行的 TouchDesigner 專案。 12 個工具涵蓋了基本功能：列出/建立/刪除節點、設定參數、在 TouchDesigner 中執行任意 Python 以及內省環境（類別目錄、節點錯誤、模組幫助）。 TouchDesigner 內的 WebServer DAT（來自“mcp_webserver_base.tox”，API ≥1.3.0）偵聽連接埠 9981；MCP 伺服器透過 HTTP 與其對話。 針對希望在 TouchDesigner 中進行 AI 配對程式設計的動作設計師、現場視覺藝術家和安裝工程師。
%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 表面中的 Python 建議 | 0 |
| get_module_help | module_name | 檢索模組文件字串 | 0 |
| get_td_info | (none) | 檢查TD版本和伺服器狀態 | 0 |
經濟拒絕 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 | 戈多是你的引擎 | 不同的DCC |