@dpantani/tdmcp 0.1.0 → 0.2.0

package/dist/knowledge/data/meta.json

@@ -1 +1 @@
-{"source":"bottobot","bottobotVersion":"2.8.0","importedAt":"2026-05-25T21:00:49.222Z","counts":{"operators":629,"pythonClasses":68,"tutorials":14,"patterns":32,"glsl":7}}
+{"source":"bottobot","bottobotVersion":"2.8.0","importedAt":"2026-05-26T08:21:03.449Z","counts":{"operators":629,"pythonClasses":68,"tutorials":14,"patterns":32,"glsl":7}}

package/dist/recipes/feedback_tunnel.json

@@ -21,14 +21,14 @@
     {
       "name": "transform1",
       "type": "transformTOP",
-      "parameters": { "scalex": 1.03, "scaley": 1.03, "rotate": 1.5 },
+      "parameters": { "sx": 1.03, "sy": 1.03, "rotate": 1.5 },
       "comment": "Zoom + rotate each frame to create the tunnel motion"
     },
     { "name": "blur1", "type": "blurTOP", "parameters": { "size": 2 } },
     {
       "name": "level1",
       "type": "levelTOP",
-      "parameters": { "gain": 0.96 },
+      "parameters": { "brightness1": 0.96 },
       "comment": "Decay / feedback gain"
     },
     { "name": "out1", "type": "nullTOP", "comment": "Output of the system" }
@@ -53,7 +53,7 @@
     {
       "name": "feedback_gain",
       "node": "level1",
-      "param": "gain",
+      "param": "brightness1",
       "value": 0.96,
       "min": 0,
       "max": 1,
@@ -62,7 +62,7 @@
     {
       "name": "zoom",
       "node": "transform1",
-      "param": "scalex",
+      "param": "sx",
       "value": 1.03,
       "min": 1,
       "max": 1.2,

package/dist/recipes/noise_landscape.json

@@ -70,7 +70,108 @@
       "min": 0,
       "max": 2,
       "label": "Terrain Height"
+    },
+    {
+      "name": "sky_r",
+      "node": "render1",
+      "param": "bgcolorr",
+      "value": 0.06,
+      "description": "Background sky red — deep indigo atmosphere instead of empty white void."
+    },
+    {
+      "name": "sky_g",
+      "node": "render1",
+      "param": "bgcolorg",
+      "value": 0.07,
+      "description": "Background sky green."
+    },
+    {
+      "name": "sky_b",
+      "node": "render1",
+      "param": "bgcolorb",
+      "value": 0.14,
+      "description": "Background sky blue."
+    },
+    {
+      "name": "sky_a",
+      "node": "render1",
+      "param": "bgcolora",
+      "value": 1,
+      "description": "Background alpha = 1 so the sky is opaque (not transparent/white)."
+    },
+    {
+      "name": "terrain_diffuse_r",
+      "node": "phong1",
+      "param": "diffr",
+      "value": 0.3,
+      "description": "Terrain diffuse red — mossy green so the landscape is coloured, not default grey."
+    },
+    {
+      "name": "terrain_diffuse_g",
+      "node": "phong1",
+      "param": "diffg",
+      "value": 0.58,
+      "description": "Terrain diffuse green."
+    },
+    {
+      "name": "terrain_diffuse_b",
+      "node": "phong1",
+      "param": "diffb",
+      "value": 0.42,
+      "description": "Terrain diffuse blue."
+    },
+    {
+      "name": "terrain_ambient_r",
+      "node": "phong1",
+      "param": "ambr",
+      "value": 0.07,
+      "description": "Ambient red — cool indigo fill matching the sky so shadow sides read as atmospheric depth, not black."
+    },
+    {
+      "name": "terrain_ambient_g",
+      "node": "phong1",
+      "param": "ambg",
+      "value": 0.11,
+      "description": "Ambient green."
+    },
+    {
+      "name": "terrain_ambient_b",
+      "node": "phong1",
+      "param": "ambb",
+      "value": 0.2,
+      "description": "Ambient blue (indigo fill)."
+    },
+    {
+      "name": "terrain_specular_r",
+      "node": "phong1",
+      "param": "specr",
+      "value": 0.7,
+      "description": "Specular red — warm sun glint catching the hill tops."
+    },
+    {
+      "name": "terrain_specular_g",
+      "node": "phong1",
+      "param": "specg",
+      "value": 0.62,
+      "description": "Specular green."
+    },
+    {
+      "name": "terrain_specular_b",
+      "node": "phong1",
+      "param": "specb",
+      "value": 0.4,
+      "description": "Specular blue (warm)."
+    },
+    {
+      "name": "terrain_shininess",
+      "node": "phong1",
+      "param": "shininess",
+      "value": 30,
+      "min": 0,
+      "max": 100,
+      "label": "Highlight Tightness",
+      "description": "Phong shininess — tighter sun highlight on the ridges."
     }
   ],
-  "preview_description": "A softly lit rolling 3D terrain of noise-driven hills viewed from a slightly elevated angle."
+  "preview_description": "A green-teal rolling 3D terrain, sun-lit with warm specular highlights on the ridges and cool indigo ambient in the valleys, set against a deep indigo atmospheric sky."
 }

package/dist/recipes/performable_feedback_tunnel.json

@@ -0,0 +1,92 @@
+{
+  "id": "performable_feedback_tunnel",
+  "name": "Performable Feedback Tunnel",
+  "description": "A feedback tunnel that ships with live controls: knobs for feedback decay, zoom, spin and blur are exposed on the container so you can perform it, animate the knobs with an LFO, or snapshot looks as presets.",
+  "tags": [
+    "feedback",
+    "generative",
+    "tunnel",
+    "abstract",
+    "noise",
+    "performable",
+    "controls",
+    "vj"
+  ],
+  "difficulty": "intermediate",
+  "td_version_min": "2022",
+  "nodes": [
+    {
+      "name": "noise1",
+      "type": "noiseTOP",
+      "parameters": { "period": 3, "mono": 1 },
+      "comment": "Seed texture that feeds the loop (mono=1 keeps it grayscale; the param is 'mono', not 'monochrome')"
+    },
+    { "name": "feedback1", "type": "feedbackTOP", "comment": "Holds the previous frame" },
+    {
+      "name": "comp1",
+      "type": "compositeTOP",
+      "parameters": { "operand": "maximum" },
+      "comment": "Combines seed + fed-back frame. 'maximum' stays bounded under feedback gain (the default multiply collapses to black)."
+    },
+    {
+      "name": "transform1",
+      "type": "transformTOP",
+      "parameters": { "sx": 1.03, "sy": 1.03, "rotate": 1.5 },
+      "comment": "Zoom + rotate each frame to create the tunnel motion (sx/sy are the scale params, not scalex/scaley)"
+    },
+    { "name": "blur1", "type": "blurTOP", "parameters": { "size": 2 } },
+    {
+      "name": "level1",
+      "type": "levelTOP",
+      "parameters": { "brightness1": 0.96 },
+      "comment": "Decay / feedback gain. levelTOP multiplies RGB via brightness1 (it has no 'gain' parameter)."
+    },
+    { "name": "out1", "type": "nullTOP", "comment": "Output of the system" }
+  ],
+  "connections": [
+    { "from": "noise1", "to": "feedback1" },
+    { "from": "noise1", "to": "comp1", "to_input": 0 },
+    { "from": "feedback1", "to": "comp1", "to_input": 1 },
+    { "from": "comp1", "to": "transform1" },
+    { "from": "transform1", "to": "blur1" },
+    { "from": "blur1", "to": "level1" },
+    { "from": "level1", "to": "out1" }
+  ],
+  "parameters": [
+    {
+      "name": "feedback_target",
+      "node": "feedback1",
+      "param": "top",
+      "value": "level1",
+      "description": "feedbackTOP samples the loop output (level1). Value resolves to the created node path."
+    }
+  ],
+  "controls": [
+    {
+      "name": "Feedback",
+      "type": "float",
+      "min": 0,
+      "max": 1,
+      "default": 0.96,
+      "bind_to": ["level1.brightness1"]
+    },
+    {
+      "name": "Zoom",
+      "type": "float",
+      "min": 1,
+      "max": 1.2,
+      "default": 1.03,
+      "bind_to": ["transform1.sx", "transform1.sy"]
+    },
+    {
+      "name": "Spin",
+      "type": "float",
+      "min": -5,
+      "max": 5,
+      "default": 1.5,
+      "bind_to": ["transform1.rotate"]
+    },
+    { "name": "Blur", "type": "float", "min": 0, "max": 8, "default": 2, "bind_to": ["blur1.size"] }
+  ],
+  "preview_description": "An endless rotating tunnel of evolving colored noise that folds into its own center, with live knobs for feedback, zoom, spin and blur."
+}

package/dist/recipes/webcam_glitch.json

@@ -10,7 +10,11 @@
     { "name": "edge", "type": "edgeTOP" },
     { "name": "rgbsplit", "type": "glslTOP", "comment": "Chromatic RGB offset" },
     { "name": "feedback1", "type": "feedbackTOP" },
-    { "name": "comp1", "type": "compositeTOP" },
+    {
+      "name": "comp1",
+      "type": "compositeTOP",
+      "parameters": { "outputresolution": "custom", "resolutionw": 1280, "resolutionh": 720 }
+    },
     { "name": "glitch", "type": "glslTOP", "comment": "Per-band horizontal displacement" },
     { "name": "out1", "type": "nullTOP" }
   ],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dpantani/tdmcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "AI-native visual creation for TouchDesigner — a production-grade MCP server.",
   "type": "module",
   "license": "MIT",

package/recipes/feedback_tunnel.json

@@ -21,14 +21,14 @@
     {
       "name": "transform1",
       "type": "transformTOP",
-      "parameters": { "scalex": 1.03, "scaley": 1.03, "rotate": 1.5 },
+      "parameters": { "sx": 1.03, "sy": 1.03, "rotate": 1.5 },
       "comment": "Zoom + rotate each frame to create the tunnel motion"
     },
     { "name": "blur1", "type": "blurTOP", "parameters": { "size": 2 } },
     {
       "name": "level1",
       "type": "levelTOP",
-      "parameters": { "gain": 0.96 },
+      "parameters": { "brightness1": 0.96 },
       "comment": "Decay / feedback gain"
     },
     { "name": "out1", "type": "nullTOP", "comment": "Output of the system" }
@@ -53,7 +53,7 @@
     {
       "name": "feedback_gain",
       "node": "level1",
-      "param": "gain",
+      "param": "brightness1",
       "value": 0.96,
       "min": 0,
       "max": 1,
@@ -62,7 +62,7 @@
     {
       "name": "zoom",
       "node": "transform1",
-      "param": "scalex",
+      "param": "sx",
       "value": 1.03,
       "min": 1,
       "max": 1.2,

package/recipes/noise_landscape.json

@@ -70,7 +70,108 @@
       "min": 0,
       "max": 2,
       "label": "Terrain Height"
+    },
+    {
+      "name": "sky_r",
+      "node": "render1",
+      "param": "bgcolorr",
+      "value": 0.06,
+      "description": "Background sky red — deep indigo atmosphere instead of empty white void."
+    },
+    {
+      "name": "sky_g",
+      "node": "render1",
+      "param": "bgcolorg",
+      "value": 0.07,
+      "description": "Background sky green."
+    },
+    {
+      "name": "sky_b",
+      "node": "render1",
+      "param": "bgcolorb",
+      "value": 0.14,
+      "description": "Background sky blue."
+    },
+    {
+      "name": "sky_a",
+      "node": "render1",
+      "param": "bgcolora",
+      "value": 1,
+      "description": "Background alpha = 1 so the sky is opaque (not transparent/white)."
+    },
+    {
+      "name": "terrain_diffuse_r",
+      "node": "phong1",
+      "param": "diffr",
+      "value": 0.3,
+      "description": "Terrain diffuse red — mossy green so the landscape is coloured, not default grey."
+    },
+    {
+      "name": "terrain_diffuse_g",
+      "node": "phong1",
+      "param": "diffg",
+      "value": 0.58,
+      "description": "Terrain diffuse green."
+    },
+    {
+      "name": "terrain_diffuse_b",
+      "node": "phong1",
+      "param": "diffb",
+      "value": 0.42,
+      "description": "Terrain diffuse blue."
+    },
+    {
+      "name": "terrain_ambient_r",
+      "node": "phong1",
+      "param": "ambr",
+      "value": 0.07,
+      "description": "Ambient red — cool indigo fill matching the sky so shadow sides read as atmospheric depth, not black."
+    },
+    {
+      "name": "terrain_ambient_g",
+      "node": "phong1",
+      "param": "ambg",
+      "value": 0.11,
+      "description": "Ambient green."
+    },
+    {
+      "name": "terrain_ambient_b",
+      "node": "phong1",
+      "param": "ambb",
+      "value": 0.2,
+      "description": "Ambient blue (indigo fill)."
+    },
+    {
+      "name": "terrain_specular_r",
+      "node": "phong1",
+      "param": "specr",
+      "value": 0.7,
+      "description": "Specular red — warm sun glint catching the hill tops."
+    },
+    {
+      "name": "terrain_specular_g",
+      "node": "phong1",
+      "param": "specg",
+      "value": 0.62,
+      "description": "Specular green."
+    },
+    {
+      "name": "terrain_specular_b",
+      "node": "phong1",
+      "param": "specb",
+      "value": 0.4,
+      "description": "Specular blue (warm)."
+    },
+    {
+      "name": "terrain_shininess",
+      "node": "phong1",
+      "param": "shininess",
+      "value": 30,
+      "min": 0,
+      "max": 100,
+      "label": "Highlight Tightness",
+      "description": "Phong shininess — tighter sun highlight on the ridges."
     }
   ],
-  "preview_description": "A softly lit rolling 3D terrain of noise-driven hills viewed from a slightly elevated angle."
+  "preview_description": "A green-teal rolling 3D terrain, sun-lit with warm specular highlights on the ridges and cool indigo ambient in the valleys, set against a deep indigo atmospheric sky."
 }

package/recipes/performable_feedback_tunnel.json

@@ -0,0 +1,92 @@
+{
+  "id": "performable_feedback_tunnel",
+  "name": "Performable Feedback Tunnel",
+  "description": "A feedback tunnel that ships with live controls: knobs for feedback decay, zoom, spin and blur are exposed on the container so you can perform it, animate the knobs with an LFO, or snapshot looks as presets.",
+  "tags": [
+    "feedback",
+    "generative",
+    "tunnel",
+    "abstract",
+    "noise",
+    "performable",
+    "controls",
+    "vj"
+  ],
+  "difficulty": "intermediate",
+  "td_version_min": "2022",
+  "nodes": [
+    {
+      "name": "noise1",
+      "type": "noiseTOP",
+      "parameters": { "period": 3, "mono": 1 },
+      "comment": "Seed texture that feeds the loop (mono=1 keeps it grayscale; the param is 'mono', not 'monochrome')"
+    },
+    { "name": "feedback1", "type": "feedbackTOP", "comment": "Holds the previous frame" },
+    {
+      "name": "comp1",
+      "type": "compositeTOP",
+      "parameters": { "operand": "maximum" },
+      "comment": "Combines seed + fed-back frame. 'maximum' stays bounded under feedback gain (the default multiply collapses to black)."
+    },
+    {
+      "name": "transform1",
+      "type": "transformTOP",
+      "parameters": { "sx": 1.03, "sy": 1.03, "rotate": 1.5 },
+      "comment": "Zoom + rotate each frame to create the tunnel motion (sx/sy are the scale params, not scalex/scaley)"
+    },
+    { "name": "blur1", "type": "blurTOP", "parameters": { "size": 2 } },
+    {
+      "name": "level1",
+      "type": "levelTOP",
+      "parameters": { "brightness1": 0.96 },
+      "comment": "Decay / feedback gain. levelTOP multiplies RGB via brightness1 (it has no 'gain' parameter)."
+    },
+    { "name": "out1", "type": "nullTOP", "comment": "Output of the system" }
+  ],
+  "connections": [
+    { "from": "noise1", "to": "feedback1" },
+    { "from": "noise1", "to": "comp1", "to_input": 0 },
+    { "from": "feedback1", "to": "comp1", "to_input": 1 },
+    { "from": "comp1", "to": "transform1" },
+    { "from": "transform1", "to": "blur1" },
+    { "from": "blur1", "to": "level1" },
+    { "from": "level1", "to": "out1" }
+  ],
+  "parameters": [
+    {
+      "name": "feedback_target",
+      "node": "feedback1",
+      "param": "top",
+      "value": "level1",
+      "description": "feedbackTOP samples the loop output (level1). Value resolves to the created node path."
+    }
+  ],
+  "controls": [
+    {
+      "name": "Feedback",
+      "type": "float",
+      "min": 0,
+      "max": 1,
+      "default": 0.96,
+      "bind_to": ["level1.brightness1"]
+    },
+    {
+      "name": "Zoom",
+      "type": "float",
+      "min": 1,
+      "max": 1.2,
+      "default": 1.03,
+      "bind_to": ["transform1.sx", "transform1.sy"]
+    },
+    {
+      "name": "Spin",
+      "type": "float",
+      "min": -5,
+      "max": 5,
+      "default": 1.5,
+      "bind_to": ["transform1.rotate"]
+    },
+    { "name": "Blur", "type": "float", "min": 0, "max": 8, "default": 2, "bind_to": ["blur1.size"] }
+  ],
+  "preview_description": "An endless rotating tunnel of evolving colored noise that folds into its own center, with live knobs for feedback, zoom, spin and blur."
+}

package/recipes/webcam_glitch.json

@@ -10,7 +10,11 @@
     { "name": "edge", "type": "edgeTOP" },
     { "name": "rgbsplit", "type": "glslTOP", "comment": "Chromatic RGB offset" },
     { "name": "feedback1", "type": "feedbackTOP" },
-    { "name": "comp1", "type": "compositeTOP" },
+    {
+      "name": "comp1",
+      "type": "compositeTOP",
+      "parameters": { "outputresolution": "custom", "resolutionw": 1280, "resolutionh": 720 }
+    },
     { "name": "glitch", "type": "glslTOP", "comment": "Per-band horizontal displacement" },
     { "name": "out1", "type": "nullTOP" }
   ],

package/td/modules/mcp/controllers/api_controller.py

@@ -74,6 +74,31 @@ def _check_auth(request):
         raise PermissionError("Unauthorized: missing or invalid bearer token.")
 
 
+_LOOPBACK_HOSTS = ("127.0.0.1", "localhost", "::1")
+
+
+def _check_origin(request):
+    """Reject browser-originated cross-origin requests (CSRF / DNS-rebinding).
+
+    The Node MCP server — the only legitimate caller — never sends an `Origin`
+    header. Browsers always attach one on cross-site requests, so a request
+    bearing a non-loopback `Origin` can only be a web page trying to drive the
+    bridge (e.g. a malicious site POSTing to http://127.0.0.1:9980/api/exec).
+    Under the default zero-auth + exec-on config that would be drive-by remote
+    code execution, so refuse it. Loopback origins stay allowed (a locally
+    served tool page still works) and same-origin / no-Origin callers are
+    unaffected. Holds even against a direct caller and independent of the
+    optional bearer token, mirroring the Node HTTP transport's DNS-rebinding
+    guard on its own port.
+    """
+    origin = _find_header(request, "origin")
+    if not origin:
+        return
+    host = urlparse(origin).hostname
+    if host not in _LOOPBACK_HOSTS:
+        raise PermissionError("Forbidden: cross-origin request rejected (origin %r)." % origin)
+
+
 def _qs(query, key, default=None):
     values = query.get(key)
     return values[0] if values else default
@@ -160,7 +185,9 @@ def _route(method, path, query, body):
         if kind == "topology":
             return analysis_service.topology(node_path, recursive=_qs(query, "recursive") == "true")
         if kind == "performance":
-            return analysis_service.performance(node_path)
+            return analysis_service.performance(
+                node_path, recursive=_qs(query, "recursive") == "true"
+            )
 
     raise ValueError("Unsupported %s %s" % (method, path))
 
@@ -226,6 +253,7 @@ def _emit_event(webserver, method, path, data):
 
 def handle(request, response, webserver=None):
     try:
+        _check_origin(request)
         _check_auth(request)
         method = (request.get("method") or "GET").upper()
         parsed = urlparse(request.get("uri", "/"))

package/td/modules/mcp/services/analysis_service.py

@@ -44,13 +44,18 @@ def topology(path, recursive=False):
     return {"nodes": nodes, "connections": connections}
 
 
-def performance(path):
+def performance(path, recursive=False):
     root = op(path)  # noqa: F821
     if root is None:
         return {"nodes": [], "total_cook_time_ms": 0.0}
     nodes = []
     total = 0.0
-    children = root.findChildren(depth=1) if hasattr(root, "findChildren") else []
+    if not hasattr(root, "findChildren"):
+        children = []
+    elif recursive:
+        children = root.findChildren()  # all descendants (cook time of nested nodes too)
+    else:
+        children = root.findChildren(depth=1)  # direct children only
     for child in children:
         cook_time = float(getattr(child, "cookTime", 0.0) or 0.0)
         total += cook_time

package/td/modules/mcp/services/api_service.py

@@ -71,9 +71,15 @@ def create_node(parent_path, type_name, name=None, parameters=None):
         raise LookupError("Parent not found: %s" % parent_path)
     cls = _resolve_type(type_name)
     node = parent.create(cls, name) if name else parent.create(cls)
+    ref = node_ref(node)
     if parameters:
-        apply_parameters(node, parameters)
-    return node_ref(node)
+        # The node is created regardless; surface any params that did not apply
+        # (unknown name or bad value) as a non-fatal warning rather than dropping
+        # them silently. The caller (create_td_node) relays these to the user.
+        _applied, failed = apply_parameters(node, parameters)
+        if failed:
+            ref["parameter_warnings"] = sorted(failed)
+    return ref
 
 
 def delete_node(path):
@@ -120,7 +126,23 @@ def update_parameters(path, parameters):
     node = op(path)  # noqa: F821
     if node is None:
         raise LookupError("Node not found: %s" % path)
-    apply_parameters(node, parameters)
+    params = parameters or {}
+    # Reject unknown parameter names up front (atomic: apply nothing) so a typo
+    # like `gain` on a levelTOP fails loudly instead of being silently dropped.
+    unknown = [k for k in params if getattr(node.par, k, None) is None]
+    if unknown:
+        raise ValueError(
+            "Unknown parameter(s) on %s (%s): %s. "
+            "Use get_td_node_parameters to see the valid parameter names."
+            % (path, op_type(node), ", ".join(sorted(unknown)))
+        )
+    applied, failed = apply_parameters(node, params)
+    if failed:
+        raise ValueError(
+            "Could not set parameter(s) on %s (%s): %s "
+            "(wrong value type or out of range?). Applied: %s."
+            % (path, op_type(node), ", ".join(sorted(failed)), ", ".join(sorted(applied)) or "none")
+        )
     return node_detail(node)