/ الدليل / الملعب / TouchDesigner MCP
← كل الخوادم ↗ GitHub
● مجتمع 8beeeaaat 🔑 يتطلب مفتاحك

TouchDesigner MCP

بواسطة 8beeeaaat · 8beeeaaat/touchdesigner-mcp

تحكم TouchDesigner الأصلي القائم على الذكاء الاصطناعي - يقوم الوكلاء بإنشاء العقد، وتعديل المعلمات، وتشغيل Python، وقراءة الأخطاء من خلال جسر WebServer DAT المحلي.

يتيح touchdesigner-mcp للوكيل تشغيل مشروع TouchDesigner قيد التشغيل عبر MCP. 12 أداة تغطي الأساسيات: قائمة/إنشاء/حذف العقد، وتعيين المعلمات، وتشغيل Python التعسفي في TouchDesigner، واستبطان البيئة (كتالوج الفئة، وأخطاء العقدة، ومساعدة الوحدة). يستمع WebServer DAT داخل TouchDesigner (من mcp_webserver_base.tox، API ≥1.3.0) على المنفذ 9981؛ يتحدث خادم MCP إليه عبر HTTP. تستهدف مصممي الحركة، وفناني العروض المرئية الحية، ومهندسي التثبيت الذين يريدون مبرمجًا مزدوجًا يعمل بالذكاء الاصطناعي داخل TouchDesigner.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

touchdesigner-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %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. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "touchdesigner-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ],
      "env": {
        "TD_WEBSERVER_HOST": "127.0.0.1",
        "TD_WEBSERVER_PORT": "9981"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_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. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "touchdesigner-mcp",
      "command": "npx",
      "args": [
        "-y",
        "touchdesigner-mcp-server"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "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.

حالات الاستخدام

استخدامات عملية: TouchDesigner MCP

سقالة تصحيح TouchDesigner للمبتدئين من موجز

👤 مصممو الحركة والمهندسون البصريون يقومون بتصميم النماذج الأولية ⏱ ~30 min intermediate

متى تستخدمه: أنت تبدأ رقعة جديدة وتريد وضع الهيكل العظمي في مكانه قبل الضبط اليدوي.

المتطلبات الأساسية
  • يعمل TouchDesigner مع تحميل mcp_webserver_base.tox — قم بتنزيل tox، ثم أدخل إلى مشروعك، ثم قم بتعيين المنفذ 9981
  • إصدار API ≥ 1.3.0 — تحقق من إصدار TouchDesigner
الخطوات
  1. وصف التصحيح
    دعم تصحيح مرئيات توليدية: جزيئات صوتية متفاعلة (الضوضاء ← التركيب)، ازدهار ما بعد المعالجة، إخراج بدقة 1080 بكسل.✓ تم النسخ
    → يقوم الوكيل بإنشاء رسم بياني متماسك للعقدة باستخدام عوامل التشغيل المحددة
  2. إصلاح الأخطاء
    الإبلاغ عن أخطاء TD وإصلاحها.✓ تم النسخ
    → يستخدم get_td_node_errors، ويصحح المعلمات، ويكرر

النتيجة: تصحيح بداية عمل يمكنك تعديله، بدلاً من السحب من الصفر.

المزالق
  • يخترع الوكيل عوامل غير موجودة — اجعله يستدعي get_td_classes أولاً والتزم بأسماء الفئات الحقيقية
اجمعها مع: filesystem

مسح المعلمات ومقارنة المخرجات المرئية

👤 يبدو ضبط الفنانين ⏱ ~20 min intermediate

متى تستخدمه: تريد استكشاف نطاق المعلمات دون النقر فوق واجهة مستخدم TD.

الخطوات
  1. وصف الاجتياح
    على الضوضاء 1، فترة الاجتياح = 0.2،0.5،1.0،2.0 والتوافقيات = 1،2،4. لقطة لكل منها عبر renderpick1.✓ تم النسخ
    → يستخدم update_td_node_parameters وexecute_python_script لحفظ اللقطات
  2. قم بتسمية الفائز
    أعجبتني الفترة = 1.0 التوافقيات = 2. تطبيق وحفظ المشروع.✓ تم النسخ
    → تم تعيين Params، وتم حفظ المشروع عبر python exec

النتيجة: تكرار أسرع؛ لقد انتهى عمل النقر التوافقي الممل.

المزالق
  • نصوص بايثون الطويلة تحظر الخيط الرئيسي لـ TD — انقسم إلى مكالمات قصيرة المدى، أو قم بالتشغيل داخل تنفيذ DAT

تعرف على واجهة برمجة تطبيقات Python الخاصة بـ TouchDesigner من خلال سؤال الوكيل

👤 المصممين الجدد في لغة Python الخاصة بـ TouchDesigner ⏱ ~10 min beginner

متى تستخدمه: أنت تكتب Script CHOP/DAT وتحتاج إلى معرفة الطريقة التي يجب الاتصال بها.

الخطوات
  1. اسأل عن الفصل
    ما هي الأساليب الموجودة في الفصل "Op" للأطفال المشي؟✓ تم النسخ
    → يستدعي الوكيل get_td_class_details ويعيد الأساليب الحقيقية
  2. انظر مثالاً قابلاً للتشغيل
    اعرض مقتطفًا قصيرًا من Python يسجل مسار كل سليل.✓ تم النسخ
    → يستخدم Snippet واجهة برمجة تطبيقات حقيقية، وليس أساليب مختلقة

النتيجة: أمثلة دقيقة لـ Python ترتكز على مثيل TouchDesigner المباشر.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

touchdesigner-mcp + filesystem

احفظ اللقطات/العروض على القرص وقم بالإشارة إليها في المنعطف التالي

بعد كل مجموعة معلمات، احفظ ملف PNG عبر renderpick1 إلى ~/td-snapshots/ وأعد قراءة البيان.✓ تم النسخ
touchdesigner-mcp + xcodebuild

تقديم وحزمة لكشك macOS

اعرض مخرجات وحزمة كحزمة تطبيقات macOS عبر xcodebuild.✓ تم النسخ
touchdesigner-mcp + filesystem

ينص مشروع الأرشيف على أنه صادرات .toe قابلة للتتبع

قم بتصدير المشروع الحالي كملف .toe وقم بتنفيذه.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
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 اقتراحات Python الأرضية في سطح API الحقيقي 0
get_module_help module_name استرداد مستندات الوحدة النمطية 0
get_td_info (none) تحقق من إصدار TD وحالة الخادم 0

التكلفة والحدود

تكلفة التشغيل

حصة API
لا أحد
الرموز لكل استدعاء
صغير: مسارات العقدة + خرائط المعلمات الصغيرة
التكلفة المالية
حر؛ ينطبق ترخيص TouchDesigner
نصيحة
تفضل update_td_node_parameters مع الخريطة بدلاً من العديد من الاستدعاءات ذات المعلمة الفردية.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا أوراق اعتماد
نقل البيانات الخارجي: HTTP إلى 127.0.0.1:<port>. لا تعرض WebServer DAT للشبكة العامة.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تم رفضه 127.0.0.1:9981

TouchDesigner لا يعمل أو WebServer DAT غير نشط. افتح السم وتأكد من أنه نشط.

تحقق: In TD console: op('mcpwebserver').par.active.eval()
إصدار API منخفض جدًا

قم بترقية TouchDesigner إلى إصدار تكون فيه واجهة برمجة التطبيقات (API) ≥ 1.3.0.

تحقق: Help → About TouchDesigner
فشل تنفيذ بايثون بصمت

تحقق من المنفذ النصي TD بحثًا عن التتبع؛ يتم طهي بعض العمليات فقط عند الاتصال بالعارض.

تحقق: Alt-T opens the textport

البدائل

TouchDesigner MCP مقابل البدائل

البديلمتى تستخدمهاالمقايضة
unrealأنت تقود مشاهد Unreal Engine، وليس تصحيحات TouchDesignerوقت تشغيل مختلف؛ DCC مختلفة
unityالوحدة هي المحرك الذي تستهدفهDCC مختلفة تماما
godot-mcp-pro-2جودو هو المحرك الخاص بكدي سي سي مختلفة

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills