n8n-mcp 2.14.6 → 2.15.0

package/dist/mcp/server.js

@@ -62,6 +62,7 @@ const handlers_workflow_diff_1 = require("./handlers-workflow-diff");
 const tools_documentation_1 = require("./tools-documentation");
 const version_1 = require("../utils/version");
 const node_utils_1 = require("../utils/node-utils");
+const node_type_normalizer_1 = require("../utils/node-type-normalizer");
 const validation_schemas_1 = require("../utils/validation-schemas");
 const protocol_version_1 = require("../utils/protocol-version");
 const telemetry_1 = require("../telemetry");
@@ -555,7 +556,7 @@ class N8NDocumentationMCPServer {
             case 'search_nodes':
                 this.validateToolParams(name, args, ['query']);
                 const limit = args.limit !== undefined ? Number(args.limit) || 20 : 20;
-                return this.searchNodes(args.query, limit, { mode: args.mode });
+                return this.searchNodes(args.query, limit, { mode: args.mode, includeExamples: args.includeExamples });
             case 'list_ai_tools':
                 return this.listAITools();
             case 'get_node_documentation':
@@ -565,14 +566,11 @@ class N8NDocumentationMCPServer {
                 return this.getDatabaseStatistics();
             case 'get_node_essentials':
                 this.validateToolParams(name, args, ['nodeType']);
-                return this.getNodeEssentials(args.nodeType);
+                return this.getNodeEssentials(args.nodeType, args.includeExamples);
             case 'search_node_properties':
                 this.validateToolParams(name, args, ['nodeType', 'query']);
                 const maxResults = args.maxResults !== undefined ? Number(args.maxResults) || 20 : 20;
                 return this.searchNodeProperties(args.nodeType, args.query, maxResults);
-            case 'get_node_for_task':
-                this.validateToolParams(name, args, ['task']);
-                return this.getNodeForTask(args.task);
             case 'list_tasks':
                 return this.listTasks(args.category);
             case 'validate_node_operation':
@@ -783,7 +781,7 @@ class N8NDocumentationMCPServer {
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -846,13 +844,15 @@ class N8NDocumentationMCPServer {
       WHERE type='table' AND name='nodes_fts'
     `).get();
         if (ftsExists) {
-            return this.searchNodesFTS(normalizedQuery, limit, searchMode);
+            logger_1.logger.debug(`Using FTS5 search with includeExamples=${options?.includeExamples}`);
+            return this.searchNodesFTS(normalizedQuery, limit, searchMode, options);
         }
         else {
-            return this.searchNodesLIKE(normalizedQuery, limit);
+            logger_1.logger.debug('Using LIKE search (no FTS5)');
+            return this.searchNodesLIKE(normalizedQuery, limit, options);
         }
     }
-    async searchNodesFTS(query, limit, mode) {
+    async searchNodesFTS(query, limit, mode, options) {
         if (!this.db)
             throw new Error('Database not initialized');
         const cleanedQuery = query.trim();
@@ -932,6 +932,32 @@ class N8NDocumentationMCPServer {
             if (mode !== 'OR') {
                 result.mode = mode;
             }
+            if (options && options.includeExamples) {
+                try {
+                    for (const nodeResult of result.results) {
+                        const examples = this.db.prepare(`
+              SELECT
+                parameters_json,
+                template_name,
+                template_views
+              FROM template_node_configs
+              WHERE node_type = ?
+              ORDER BY rank
+              LIMIT 2
+            `).all(nodeResult.workflowNodeType);
+                        if (examples.length > 0) {
+                            nodeResult.examples = examples.map((ex) => ({
+                                configuration: JSON.parse(ex.parameters_json),
+                                template: ex.template_name,
+                                views: ex.template_views
+                            }));
+                        }
+                    }
+                }
+                catch (error) {
+                    logger_1.logger.error(`Failed to add examples:`, error);
+                }
+            }
             telemetry_1.telemetry.trackSearchQuery(query, scoredNodes.length, mode ?? 'OR');
             return result;
         }
@@ -1059,18 +1085,18 @@ class N8NDocumentationMCPServer {
         }
         return dp[m][n];
     }
-    async searchNodesLIKE(query, limit) {
+    async searchNodesLIKE(query, limit, options) {
         if (!this.db)
             throw new Error('Database not initialized');
         if (query.startsWith('"') && query.endsWith('"')) {
             const exactPhrase = query.slice(1, -1);
             const nodes = this.db.prepare(`
-        SELECT * FROM nodes 
+        SELECT * FROM nodes
         WHERE node_type LIKE ? OR display_name LIKE ? OR description LIKE ?
         LIMIT ?
       `).all(`%${exactPhrase}%`, `%${exactPhrase}%`, `%${exactPhrase}%`, limit * 3);
             const rankedNodes = this.rankSearchResults(nodes, exactPhrase, limit);
-            return {
+            const result = {
                 query,
                 results: rankedNodes.map(node => ({
                     nodeType: node.node_type,
@@ -1082,6 +1108,33 @@ class N8NDocumentationMCPServer {
                 })),
                 totalCount: rankedNodes.length
             };
+            if (options?.includeExamples) {
+                for (const nodeResult of result.results) {
+                    try {
+                        const examples = this.db.prepare(`
+              SELECT
+                parameters_json,
+                template_name,
+                template_views
+              FROM template_node_configs
+              WHERE node_type = ?
+              ORDER BY rank
+              LIMIT 2
+            `).all(nodeResult.workflowNodeType);
+                        if (examples.length > 0) {
+                            nodeResult.examples = examples.map((ex) => ({
+                                configuration: JSON.parse(ex.parameters_json),
+                                template: ex.template_name,
+                                views: ex.template_views
+                            }));
+                        }
+                    }
+                    catch (error) {
+                        logger_1.logger.warn(`Failed to fetch examples for ${nodeResult.nodeType}:`, error.message);
+                    }
+                }
+            }
+            return result;
         }
         const words = query.toLowerCase().split(/\s+/).filter(w => w.length > 0);
         if (words.length === 0) {
@@ -1096,7 +1149,7 @@ class N8NDocumentationMCPServer {
       LIMIT ?
     `).all(...params);
         const rankedNodes = this.rankSearchResults(nodes, query, limit);
-        return {
+        const result = {
             query,
             results: rankedNodes.map(node => ({
                 nodeType: node.node_type,
@@ -1108,6 +1161,33 @@ class N8NDocumentationMCPServer {
             })),
             totalCount: rankedNodes.length
         };
+        if (options?.includeExamples) {
+            for (const nodeResult of result.results) {
+                try {
+                    const examples = this.db.prepare(`
+            SELECT
+              parameters_json,
+              template_name,
+              template_views
+            FROM template_node_configs
+            WHERE node_type = ?
+            ORDER BY rank
+            LIMIT 2
+          `).all(nodeResult.workflowNodeType);
+                    if (examples.length > 0) {
+                        nodeResult.examples = examples.map((ex) => ({
+                            configuration: JSON.parse(ex.parameters_json),
+                            template: ex.template_name,
+                            views: ex.template_views
+                        }));
+                    }
+                }
+                catch (error) {
+                    logger_1.logger.warn(`Failed to fetch examples for ${nodeResult.nodeType}:`, error.message);
+                }
+            }
+        }
+        return result;
     }
     calculateRelevance(node, query) {
         const lowerQuery = query.toLowerCase();
@@ -1253,7 +1333,7 @@ class N8NDocumentationMCPServer {
         await this.ensureInitialized();
         if (!this.db)
             throw new Error('Database not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.db.prepare(`
       SELECT node_type, display_name, documentation, description 
       FROM nodes 
@@ -1362,15 +1442,15 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             })),
         };
     }
-    async getNodeEssentials(nodeType) {
+    async getNodeEssentials(nodeType, includeExamples) {
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const cacheKey = `essentials:${nodeType}`;
+        const cacheKey = `essentials:${nodeType}:${includeExamples ? 'withExamples' : 'basic'}`;
         const cached = this.cache.get(cacheKey);
         if (cached)
             return cached;
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -1417,6 +1497,50 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 developmentStyle: node.developmentStyle ?? 'programmatic'
             }
         };
+        if (includeExamples) {
+            try {
+                const fullNodeType = (0, node_utils_1.getWorkflowNodeType)(node.package ?? 'n8n-nodes-base', node.nodeType);
+                const examples = this.db.prepare(`
+          SELECT
+            parameters_json,
+            template_name,
+            template_views,
+            complexity,
+            use_cases,
+            has_credentials,
+            has_expressions
+          FROM template_node_configs
+          WHERE node_type = ?
+          ORDER BY rank
+          LIMIT 3
+        `).all(fullNodeType);
+                if (examples.length > 0) {
+                    result.examples = examples.map((ex) => ({
+                        configuration: JSON.parse(ex.parameters_json),
+                        source: {
+                            template: ex.template_name,
+                            views: ex.template_views,
+                            complexity: ex.complexity
+                        },
+                        useCases: ex.use_cases ? JSON.parse(ex.use_cases).slice(0, 2) : [],
+                        metadata: {
+                            hasCredentials: ex.has_credentials === 1,
+                            hasExpressions: ex.has_expressions === 1
+                        }
+                    }));
+                    result.examplesCount = examples.length;
+                }
+                else {
+                    result.examples = [];
+                    result.examplesCount = 0;
+                }
+            }
+            catch (error) {
+                logger_1.logger.warn(`Failed to fetch examples for ${nodeType}:`, error.message);
+                result.examples = [];
+                result.examplesCount = 0;
+            }
+        }
         this.cache.set(cacheKey, result, 3600);
         return result;
     }
@@ -1424,7 +1548,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -1462,37 +1586,6 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             searchedIn: allProperties.length + ' properties'
         };
     }
-    async getNodeForTask(task) {
-        const template = task_templates_1.TaskTemplates.getTaskTemplate(task);
-        if (!template) {
-            const similar = task_templates_1.TaskTemplates.searchTasks(task);
-            throw new Error(`Unknown task: ${task}. ` +
-                (similar.length > 0
-                    ? `Did you mean: ${similar.slice(0, 3).join(', ')}?`
-                    : `Use 'list_tasks' to see available tasks.`));
-        }
-        return {
-            task: template.task,
-            description: template.description,
-            nodeType: template.nodeType,
-            configuration: template.configuration,
-            userMustProvide: template.userMustProvide,
-            optionalEnhancements: template.optionalEnhancements || [],
-            notes: template.notes || [],
-            example: {
-                node: {
-                    type: template.nodeType,
-                    parameters: template.configuration
-                },
-                userInputsNeeded: template.userMustProvide.map(p => ({
-                    property: p.property,
-                    currentValue: this.getPropertyValue(template.configuration, p.property),
-                    description: p.description,
-                    example: p.example
-                }))
-            }
-        };
-    }
     getPropertyValue(config, path) {
         const parts = path.split('.');
         let value = config;
@@ -1547,7 +1640,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -1584,7 +1677,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -1622,7 +1715,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);
@@ -1815,7 +1908,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.repository)
             throw new Error('Repository not initialized');
-        const normalizedType = (0, node_utils_1.normalizeNodeType)(nodeType);
+        const normalizedType = node_type_normalizer_1.NodeTypeNormalizer.normalizeToFullForm(nodeType);
         let node = this.repository.getNode(normalizedType);
         if (!node && normalizedType !== nodeType) {
             node = this.repository.getNode(nodeType);