touchdesigner-mcp-server 1.1.0 → 1.1.1

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

@@ -1,83 +1,18 @@
-import { z } from "zod";
 import { REFERENCE_COMMENT, TOOL_NAMES } from "../../../core/constants.js";
 import { handleToolError } from "../../../core/errorHandling.js";
 import { createNodeBody, deleteNodeQueryParams, execNodeMethodBody, execPythonScriptBody, getNodeDetailQueryParams, getNodesQueryParams, getTdPythonClassDetailsParams, updateNodeBody, } from "../../../gen/mcp/touchDesignerAPI.zod.js";
-import { getTouchDesignerToolMetadata } from "../metadata/touchDesignerToolMetadata.js";
-import { formatClassDetails, formatClassList, formatCreateNodeResult, formatDeleteNodeResult, formatExecNodeMethodResult, formatNodeDetails, formatNodeList, formatScriptResult, formatTdInfo, formatToolMetadata, formatUpdateNodeResult, } from "../presenter/index.js";
-import { detailOnlyFormattingSchema, formattingOptionsSchema, } from "../types.js";
-const execPythonScriptToolSchema = execPythonScriptBody.extend(detailOnlyFormattingSchema.shape);
-const tdInfoToolSchema = detailOnlyFormattingSchema;
-const getNodesToolSchema = getNodesQueryParams.extend(formattingOptionsSchema.shape);
-const getNodeDetailToolSchema = getNodeDetailQueryParams.extend(formattingOptionsSchema.shape);
-const createNodeToolSchema = createNodeBody.extend(detailOnlyFormattingSchema.shape);
-const updateNodeToolSchema = updateNodeBody.extend(detailOnlyFormattingSchema.shape);
-const deleteNodeToolSchema = deleteNodeQueryParams.extend(detailOnlyFormattingSchema.shape);
-const classListToolSchema = formattingOptionsSchema;
-const classDetailToolSchema = getTdPythonClassDetailsParams.extend(formattingOptionsSchema.shape);
-const execNodeMethodToolSchema = execNodeMethodBody.extend(detailOnlyFormattingSchema.shape);
-const describeToolsSchema = detailOnlyFormattingSchema.extend({
-    filter: z
-        .string()
-        .min(1)
-        .describe("Optional keyword to filter by tool name, module path, or parameter description")
-        .optional(),
-});
 export function registerTdTools(server, logger, tdClient) {
-    const toolMetadataEntries = getTouchDesignerToolMetadata();
-    server.tool(TOOL_NAMES.DESCRIBE_TD_TOOLS, "Generate a filesystem-oriented manifest of available TouchDesigner tools", describeToolsSchema.strict().shape, async (params = {}) => {
+    server.tool(TOOL_NAMES.GET_TD_INFO, "Get server information from TouchDesigner", async () => {
         try {
-            const { detailLevel, responseFormat, filter } = params;
-            const normalizedFilter = filter?.trim().toLowerCase();
-            const filteredEntries = normalizedFilter
-                ? toolMetadataEntries.filter((entry) => matchesMetadataFilter(entry, normalizedFilter))
-                : toolMetadataEntries;
-            if (filteredEntries.length === 0) {
-                const message = filter
-                    ? `No TouchDesigner tools matched filter "${filter}".`
-                    : "No TouchDesigner tools are registered.";
-                return {
-                    content: [
-                        {
-                            type: "text",
-                            text: message,
-                        },
-                    ],
-                };
-            }
-            const formattedText = formatToolMetadata(filteredEntries, {
-                detailLevel: detailLevel ?? (filter ? "summary" : "minimal"),
-                responseFormat,
-                filter: normalizedFilter,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: formattedText,
-                    },
-                ],
-            };
-        }
-        catch (error) {
-            return handleToolError(error, logger, TOOL_NAMES.DESCRIBE_TD_TOOLS);
-        }
-    });
-    server.tool(TOOL_NAMES.GET_TD_INFO, "Get server information from TouchDesigner", tdInfoToolSchema.strict().shape, async (params = {}) => {
-        try {
-            const { detailLevel, responseFormat } = params;
             const result = await tdClient.getTdInfo();
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatTdInfo(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Server information: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -86,24 +21,19 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_INFO);
         }
     });
-    server.tool(TOOL_NAMES.EXECUTE_PYTHON_SCRIPT, "Execute a Python script in TouchDesigner (detailLevel=minimal|summary|detailed, responseFormat=json|yaml|markdown)", execPythonScriptToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.EXECUTE_PYTHON_SCRIPT, "Execute Python script directly in TouchDesigner", execPythonScriptBody.strict().shape, async (params) => {
         try {
-            const { detailLevel, responseFormat, ...scriptParams } = params;
-            logger.debug(`Executing script: ${scriptParams.script}`);
-            const result = await tdClient.execPythonScript(scriptParams);
+            const { script } = params;
+            logger.debug(`Executing script: ${script}`);
+            const result = await tdClient.execPythonScript(params);
             if (!result.success) {
                 throw result.error;
             }
-            // Use formatter for token-optimized response
-            const formattedText = formatScriptResult(result, scriptParams.script, {
-                detailLevel: detailLevel ?? "summary",
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Script executed successfully. Result: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -112,22 +42,22 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.EXECUTE_PYTHON_SCRIPT);
         }
     });
-    server.tool(TOOL_NAMES.CREATE_TD_NODE, "Create a new node in TouchDesigner", createNodeToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.CREATE_TD_NODE, "Create a new node in TouchDesigner", createNodeBody.strict().shape, async (params) => {
         try {
-            const { detailLevel, responseFormat, ...createParams } = params;
-            const result = await tdClient.createNode(createParams);
+            const { parentPath, nodeType, nodeName } = params;
+            const result = await tdClient.createNode({
+                parentPath,
+                nodeType,
+                nodeName,
+            });
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatCreateNodeResult(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Node created successfully: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -136,22 +66,17 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.CREATE_TD_NODE, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.DELETE_TD_NODE, "Delete an existing node in TouchDesigner", deleteNodeToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.DELETE_TD_NODE, "Delete an existing node in TouchDesigner", deleteNodeQueryParams.strict().shape, async (params) => {
         try {
-            const { detailLevel, responseFormat, ...deleteParams } = params;
-            const result = await tdClient.deleteNode(deleteParams);
+            const result = await tdClient.deleteNode(params);
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatDeleteNodeResult(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Node deleted successfully: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -160,27 +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, "List nodes under a path with token-optimized output (detailLevel+limit supported)", getNodesToolSchema.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 { detailLevel, limit, responseFormat, ...queryParams } = params;
-            const result = await tdClient.getNodes(queryParams);
+            const result = await tdClient.getNodes(params);
             if (!result.success) {
                 throw result.error;
             }
-            // Use formatter for token-optimized response
-            const fallbackMode = queryParams.includeProperties
-                ? "detailed"
-                : "summary";
-            const formattedText = formatNodeList(result.data, {
-                detailLevel: detailLevel ?? fallbackMode,
-                limit,
-                responseFormat,
-            });
+            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: formattedText,
+                        text: `Project nodes retrieved (${nodeCount} nodes)${performanceNote}: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -189,24 +109,18 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODES, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.GET_TD_NODE_PARAMETERS, "Get node parameters with concise/detailed formatting (detailLevel+limit supported)", getNodeDetailToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.GET_TD_NODE_PARAMETERS, "Get parameters of a specific node in TouchDesigner", getNodeDetailQueryParams.strict().shape, async (params) => {
         try {
-            const { detailLevel, limit, responseFormat, ...queryParams } = params;
-            const result = await tdClient.getNodeDetail(queryParams);
+            const { nodePath } = params;
+            const result = await tdClient.getNodeDetail(params);
             if (!result.success) {
                 throw result.error;
             }
-            // Use formatter for token-optimized response
-            const formattedText = formatNodeDetails(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                limit,
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Node parameters for node at path ${nodePath}: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -215,22 +129,17 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_NODE_PARAMETERS, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.UPDATE_TD_NODE_PARAMETERS, "Update parameters of a specific node in TouchDesigner", updateNodeToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.UPDATE_TD_NODE_PARAMETERS, "Update parameters of a specific node in TouchDesigner", updateNodeBody.strict().shape, async (params) => {
         try {
-            const { detailLevel, responseFormat, ...updateParams } = params;
-            const result = await tdClient.updateNode(updateParams);
+            const result = await tdClient.updateNode(params);
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatUpdateNodeResult(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Node parameters updated successfully: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -239,20 +148,26 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.UPDATE_TD_NODE_PARAMETERS, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.EXECUTE_NODE_METHOD, "Execute a method on a specific node in TouchDesigner", execNodeMethodToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.EXECUTE_NODE_METHOD, "Execute a method on a specific node in TouchDesigner", execNodeMethodBody.strict().shape, async (params) => {
         try {
-            const { detailLevel, responseFormat, ...execParams } = params;
-            const { nodePath, method, args, kwargs } = execParams;
-            const result = await tdClient.execNodeMethod(execParams);
+            const { nodePath, method, args } = params;
+            const result = await tdClient.execNodeMethod(params);
             if (!result.success) {
                 throw result.error;
             }
-            const formattedText = formatExecNodeMethodResult(result.data, { nodePath, method, args, kwargs }, { detailLevel: detailLevel ?? "summary", responseFormat });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `op('${nodePath}').${method}(${args?.map((v) => `"${v}"`).join(",")}${params.kwargs
+                            ? Object.entries(params.kwargs)
+                                .map(([key, value]) => `${key}=${JSON.stringify(value)}`)
+                                .join(", ")
+                            : ""})`,
+                    },
+                    {
+                        type: "text",
+                        text: JSON.stringify(result, null, 2),
                     },
                 ],
             };
@@ -262,23 +177,17 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.EXECUTE_NODE_METHOD, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.GET_TD_CLASSES, "List TouchDesigner Python classes/modules (detailLevel+limit supported)", classListToolSchema.strict().shape, async (params = {}) => {
+    server.tool(TOOL_NAMES.GET_TD_CLASSES, "Get list of classes and modules in TouchDesigner", async () => {
         try {
             const result = await tdClient.getClasses();
             if (!result.success) {
                 throw result.error;
             }
-            // Use formatter for token-optimized response
-            const formattedText = formatClassList(result.data, {
-                detailLevel: params.detailLevel ?? "summary",
-                limit: params.limit ?? 50,
-                responseFormat: params.responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `TouchDesigner classes list: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -287,24 +196,18 @@ export function registerTdTools(server, logger, tdClient) {
             return handleToolError(error, logger, TOOL_NAMES.GET_TD_CLASSES, REFERENCE_COMMENT);
         }
     });
-    server.tool(TOOL_NAMES.GET_TD_CLASS_DETAILS, "Get information about a TouchDesigner class/module (detailLevel+limit supported)", classDetailToolSchema.strict().shape, async (params) => {
+    server.tool(TOOL_NAMES.GET_TD_CLASS_DETAILS, "Get detailed information about a specific TouchDesigner class or module", getTdPythonClassDetailsParams.strict().shape, async (params) => {
         try {
-            const { className, detailLevel, limit, responseFormat } = params;
+            const { className } = params;
             const result = await tdClient.getClassDetails(className);
             if (!result.success) {
                 throw result.error;
             }
-            // Use formatter for token-optimized response
-            const formattedText = formatClassDetails(result.data, {
-                detailLevel: detailLevel ?? "summary",
-                limit: limit ?? 30,
-                responseFormat,
-            });
             return {
                 content: [
                     {
                         type: "text",
-                        text: formattedText,
+                        text: `Details for ${className}: ${JSON.stringify(result, null, 2)}`,
                     },
                 ],
             };
@@ -314,18 +217,3 @@ export function registerTdTools(server, logger, tdClient) {
         }
     });
 }
-function matchesMetadataFilter(entry, keyword) {
-    const normalizedKeyword = keyword.toLowerCase();
-    const haystacks = [
-        entry.functionName,
-        entry.modulePath,
-        entry.description,
-        entry.category,
-        entry.tool,
-        entry.notes ?? "",
-    ];
-    if (haystacks.some((value) => value.toLowerCase().includes(normalizedKeyword))) {
-        return true;
-    }
-    return entry.parameters.some((param) => [param.name, param.type, param.description ?? ""].some((value) => value.toLowerCase().includes(normalizedKeyword)));
-}

package/dist/features/tools/types.js

@@ -1,26 +1 @@
-import { z } from "zod";
-/**
- * Shared Zod schemas for MCP tool formatting parameters.
- * These stay on the TypeScript side only and are not sent to TouchDesigner.
- */
-export const detailLevelSchema = z
-    .enum(["minimal", "summary", "detailed"])
-    .describe("Response detail level for tool output (minimal, summary, or detailed)");
-export const limitSchema = z
-    .number()
-    .int()
-    .min(1)
-    .max(500)
-    .describe("Maximum number of items to include in formatted output");
-export const presenterFormatSchema = z
-    .enum(["json", "yaml", "markdown"])
-    .describe("Structured output format for formatted responses");
-export const detailOnlyFormattingSchema = z.object({
-    detailLevel: detailLevelSchema.optional(),
-    responseFormat: presenterFormatSchema.optional(),
-});
-export const formattingOptionsSchema = z.object({
-    detailLevel: detailLevelSchema.optional(),
-    limit: limitSchema.optional(),
-    responseFormat: presenterFormatSchema.optional(),
-});
+"use strict";

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: 1.1.0
+ * OpenAPI spec version: 1.1.1
  */
 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: 1.1.0
+ * OpenAPI spec version: 1.1.1
  */
 import { z as zod } from 'zod';
 /**

package/dist/server/touchDesignerServer.js

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

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "touchdesigner-mcp-server",
-	"version": "1.1.0",
+	"version": "1.1.1",
 	"description": "MCP server for TouchDesigner",
 	"repository": {
 		"type": "git",
@@ -29,18 +29,17 @@
 		"@types/ws": "^8.18.1",
 		"@types/yargs": "^17.0.33",
 		"axios": "^1.12.2",
-		"mustache": "^4.2.0",
 		"zod": "3.25.76"
 	},
 	"devDependencies": {
 		"@biomejs/biome": "2.2.4",
 		"@openapitools/openapi-generator-cli": "^2.23.1",
 		"@types/jsdom": "^21.1.7",
-		"@types/mustache": "^4.2.6",
 		"@types/node": "^24.4.0",
 		"@vitest/coverage-v8": "^3.2.4",
 		"archiver": "^7.0.1",
 		"msw": "^2.11.2",
+		"mustache": "^4.2.0",
 		"npm-run-all": "^4.1.5",
 		"orval": "^7.11.2",
 		"shx": "^0.4.0",
@@ -62,7 +61,7 @@
 	"scripts": {
 		"build": "run-s build:*",
 		"build:gen": "npm run gen",
-		"build:dist": "tsc && shx chmod +x dist/*.js && shx cp -r src/features/tools/presenter/templates dist/features/tools/presenter/",
+		"build:dist": "tsc && shx chmod +x dist/*.js",
 		"build:dxt": "npx @anthropic-ai/dxt pack dxt/ touchdesigner-mcp.dxt",
 		"lint": "run-p lint:*",
 		"lint:biome": "biome check",