touchdesigner-mcp-server 0.2.13 → 0.3.0

package/dist/features/tools/handlers/tdTools.js

@@ -85,17 +85,22 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.DELETE_TD_NODE, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.GET_TD_NODES, "Get all nodes in the parent path", getNodesQueryParams.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.GET_TD_NODES, "Get all nodes in the parent path (lightweight by default for better performance)", getNodesQueryParams.strict().shape, async (params) => {
         try {
             const result = await tdClient.getNodes(params);
             if (!result.success) {
                 throw result.error;
             }
+            const nodeCount = result.data?.nodes?.length || 0;
+            const isLightweight = !params.includeProperties;
+            const performanceNote = isLightweight
+                ? " (lightweight mode - set includeProperties=true for full node details)"
+                : " (full mode with properties)";
             return {
                 content: [
                     {
                         type: "text",
-                        text: `Project nodes retrieved: ${JSON.stringify(result, null, 2)}`,
+                        text: `Project nodes retrieved (${nodeCount} nodes)${performanceNote}: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };

package/dist/gen/endpoints/TouchDesignerAPI.js

@@ -3,7 +3,7 @@
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 0.2.13
+ * OpenAPI spec version: 0.3.0
  */
 import { customInstance } from '../../api/customInstance.js';
 // eslint-disable-next-line @typescript-eslint/no-redeclare

package/dist/gen/mcp/touchDesignerAPI.zod.js

@@ -3,7 +3,7 @@
  * Do not edit manually.
  * TouchDesigner API
  * OpenAPI schema for generating TouchDesigner API client code
- * OpenAPI spec version: 0.2.13
+ * OpenAPI spec version: 0.3.0
  */
 import { z as zod } from 'zod';
 /**
@@ -30,9 +30,11 @@ export const deleteNodeResponse = zod.object({
  * @summary Get nodes in the path
  */
 export const getNodesQueryPatternDefault = "*";
+export const getNodesQueryIncludePropertiesDefault = false;
 export const getNodesQueryParams = zod.object({
     "parentPath": zod.string().describe('Parent path  e.g., \"/project1\"'),
-    "pattern": zod.string().default(getNodesQueryPatternDefault).describe('Pattern to match against node names e.g., \"null*\"')
+    "pattern": zod.string().default(getNodesQueryPatternDefault).describe('Pattern to match against node names e.g., \"null*\"'),
+    "includeProperties": zod.boolean().optional().describe('Whether to include full node properties in the response (default false for better performance)')
 });
 export const getNodesResponse = zod.object({
     "success": zod.boolean().describe('Whether the operation was successful'),

package/dist/server/touchDesignerServer.js

@@ -18,7 +18,7 @@ export class TouchDesignerServer {
     constructor() {
         this.server = new McpServer({
             name: "TouchDesigner",
-            version: "0.2.13",
+            version: "0.3.0",
         }, {
             capabilities: {
                 prompts: {},

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "touchdesigner-mcp-server",
-	"version": "0.2.13",
+	"version": "0.3.0",
 	"description": "MCP server for TouchDesigner",
 	"repository": {
 		"type": "git",

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

@@ -55,7 +55,7 @@ class ApiServiceProtocol(Protocol):
 
     def get_td_info(self) -> Result: ...
 
-    def get_nodes(self, parent_path: str, pattern: Optional[str] = None) -> Result: ...
+    def get_nodes(self, parent_path: str, pattern: Optional[str] = None, include_properties: bool = False) -> Result: ...
 
     def create_node(
         self,
@@ -417,6 +417,7 @@ class APIControllerOpenAPI(IController):
         self,
         parentPath: str,
         pattern: Optional[str] = None,
+        includeProperties: Optional[bool] = None,
         body: Optional[str] = None,
         **kwargs,
     ) -> Result:
@@ -426,11 +427,15 @@ class APIControllerOpenAPI(IController):
         Args:
             parentPath: Path of the parent node to get children from
             pattern: Optional pattern to filter nodes by
+            includeProperties: Whether to include full node properties (default: False)
 
         Returns:
             List of nodes under the specified parent path
         """
-        service_result = self._service.get_nodes(parentPath, pattern)
+        # Convert camelCase to snake_case and provide default value
+        include_properties = includeProperties if includeProperties is not None else False
+
+        service_result = self._service.get_nodes(parentPath, pattern, include_properties)
         response_data = GetNodes200Response().from_dict(service_result)
         return response_data.to_dict()
 

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

@@ -132,12 +132,13 @@ class TouchDesignerApiService(IApiService):
         node_info = self._get_node_summary(node)
         return success_result(node_info)
 
-    def get_nodes(self, parent_path: str, pattern: Optional[str] = None) -> Result:
+    def get_nodes(self, parent_path: str, pattern: Optional[str] = None, include_properties: bool = False) -> Result:
         """Get nodes under the specified parent path, optionally filtered by pattern
 
         Args:
             parent_path: Path to the parent node
             pattern: Pattern to filter nodes by name (e.g. "text*" for all nodes starting with "text")
+            include_properties: Whether to include full node properties (default False for better performance)
 
         Returns:
             Result: Success with list of nodes or error
@@ -157,7 +158,10 @@ class TouchDesignerApiService(IApiService):
             log_message("Calling parent_node.findChildren(depth=1)", LogLevel.DEBUG)
             nodes = parent_node.findChildren(depth=1)
 
-        node_summaries = [self._get_node_summary(node) for node in nodes]
+        if include_properties:
+            node_summaries = [self._get_node_summary(node) for node in nodes]
+        else:
+            node_summaries = [self._get_node_summary_light(node) for node in nodes]
 
         return success_result({"nodes": node_summaries})
 
@@ -357,8 +361,6 @@ class TouchDesignerApiService(IApiService):
         if node is None or not node.valid:
             raise error_result(f"Node not found at path: {node_path}")
 
-        node_detail = self.get_node_detail(node_path)
-        current_properties = node_detail.get("data", {})
         updated_properties = []
         failed_properties = []
 
@@ -437,6 +439,24 @@ class TouchDesignerApiService(IApiService):
 
         return params_dict
 
+    def _get_node_summary_light(self, node) -> Dict:
+        """Get lightweight information about a node (without properties for better performance)"""
+        try:
+            node_info = {
+                "id": node.id,
+                "name": node.name,
+                "path": node.path,
+                "opType": node.OPType,
+                "properties": {},  # Empty properties for lightweight response
+            }
+
+            return node_info
+        except Exception as e:
+            log_message(
+                f"Error collecting node information: {str(e)}", LogLevel.WARNING
+            )
+            return {"name": node.name if hasattr(node, "name") else "unknown"}
+
     def _get_node_summary(self, node) -> Dict:
         """Get detailed information about a node"""
         try:

package/td/modules/td_server/openapi_server/controllers/default_controller.py

@@ -94,7 +94,7 @@ def get_node_detail(node_path):  # noqa: E501
     return 'do some magic!'
 
 
-def get_nodes(parent_path, pattern=None):  # noqa: E501
+def get_nodes(parent_path, pattern=None, include_properties=None):  # noqa: E501
     """Get nodes in the path
 
      # noqa: E501
@@ -103,6 +103,8 @@ def get_nodes(parent_path, pattern=None):  # noqa: E501
     :type parent_path: str
     :param pattern: Pattern to match against node names e.g., \"null*\"
     :type pattern: str
+    :param include_properties: Whether to include full node properties in the response (default false for better performance)
+    :type include_properties: bool
 
     :rtype: Union[GetNodes200Response, Tuple[GetNodes200Response, int], Tuple[GetNodes200Response, int, Dict[str, str]]
     """

package/td/modules/td_server/openapi_server/openapi/openapi.yaml

@@ -2,7 +2,7 @@ openapi: 3.0.0
 info:
   description: OpenAPI schema for generating TouchDesigner API client code
   title: TouchDesigner API
-  version: 0.2.13
+  version: 0.3.0
 servers:
 - url: "{baseUrl}"
   variables:
@@ -47,6 +47,15 @@ paths:
           default: '*'
           description: "e.g., \"null*\""
           type: string
+      - description: Whether to include full node properties in the response (default
+          false for better performance)
+        in: query
+        name: includeProperties
+        required: false
+        schema:
+          default: false
+          description: Include node properties in response
+          type: boolean
       responses:
         "200":
           content:

package/td/modules/td_server/openapi_server/test/test_default_controller.py

@@ -119,7 +119,8 @@ class TestDefaultController(BaseTestCase):
         Get nodes in the path
         """
         query_string = [('parentPath', 'parent_path_example'),
-                        ('pattern', '*')]
+                        ('pattern', '*'),
+                        ('includeProperties', False)]
         headers = { 
             'Accept': 'application/json',
         }