n8n-mcp 2.14.7 → 2.15.0

package/dist/mcp/server.d.ts

@@ -35,7 +35,6 @@ export declare class N8NDocumentationMCPServer {
     private getDatabaseStatistics;
     private getNodeEssentials;
     private searchNodeProperties;
-    private getNodeForTask;
     private getPropertyValue;
     private listTasks;
     private validateNodeConfig;

package/dist/mcp/server.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAqB5D,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAgC;IAC1C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,qBAAqB,CAAsB;gBAEvC,eAAe,CAAC,EAAE,eAAe;YA2D/B,kBAAkB;YAsBlB,wBAAwB;YAgBxB,iBAAiB;IAO/B,OAAO,CAAC,aAAa;IA+QrB,OAAO,CAAC,wBAAwB;IAoFhC,OAAO,CAAC,kBAAkB;IAqE1B,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,qBAAqB;YAoSf,SAAS;YA2DT,WAAW;YAiEX,WAAW;YAsCX,cAAc;YAwId,gBAAgB;IAqD9B,OAAO,CAAC,mBAAmB;IAwE3B,OAAO,CAAC,eAAe;YAsBT,eAAe;IAqE7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,uBAAuB;IA0D/B,OAAO,CAAC,iBAAiB;YAqFX,WAAW;YAgCX,oBAAoB;YA2EpB,qBAAqB;YAwDrB,iBAAiB;YA+EjB,oBAAoB;YAsDpB,cAAc;IAqC5B,OAAO,CAAC,gBAAgB;YAiBV,SAAS;YA6CT,kBAAkB;YA+DlB,uBAAuB;YAsDvB,iBAAiB;IAqE/B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IAwD/B,OAAO,CAAC,iBAAiB;YAoDX,mBAAmB;YAkGnB,qBAAqB;IAS7B,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAS9B,aAAa;YAcb,iBAAiB;YAoBjB,WAAW;YAwBX,eAAe;YAqBf,mBAAmB;YAwBnB,yBAAyB;IA4CvC,OAAO,CAAC,kBAAkB;YAiBZ,gBAAgB;YA6HhB,2BAA2B;YAiE3B,2BAA2B;IAyEnC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AAqCA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAqB5D,qBAAa,yBAAyB;IACpC,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,EAAE,CAAgC;IAC1C,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,eAAe,CAAgC;IACvD,OAAO,CAAC,WAAW,CAAgB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,eAAe,CAAC,CAAkB;IAC1C,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,qBAAqB,CAAsB;gBAEvC,eAAe,CAAC,EAAE,eAAe;YA2D/B,kBAAkB;YAsBlB,wBAAwB;YAgBxB,iBAAiB;IAO/B,OAAO,CAAC,aAAa;IA+QrB,OAAO,CAAC,wBAAwB;IAoFhC,OAAO,CAAC,kBAAkB;IAqE1B,OAAO,CAAC,uBAAuB;IAiB/B,OAAO,CAAC,qBAAqB;YAiSf,SAAS;YA2DT,WAAW;YAiEX,WAAW;YAyCX,cAAc;YAyKd,gBAAgB;IAqD9B,OAAO,CAAC,mBAAmB;IAwE3B,OAAO,CAAC,eAAe;YAsBT,eAAe;IAqI7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,uBAAuB;IA0D/B,OAAO,CAAC,iBAAiB;YAqFX,WAAW;YAgCX,oBAAoB;YA2EpB,qBAAqB;YAwDrB,iBAAiB;YA6HjB,oBAAoB;IAsDlC,OAAO,CAAC,gBAAgB;YAiBV,SAAS;YA6CT,kBAAkB;YA+DlB,uBAAuB;YAsDvB,iBAAiB;IAqE/B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IAwD/B,OAAO,CAAC,iBAAiB;YAoDX,mBAAmB;YAkGnB,qBAAqB;IAS7B,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAS9B,aAAa;YAcb,iBAAiB;YAoBjB,WAAW;YAwBX,eAAe;YAqBf,mBAAmB;YAwBnB,yBAAyB;IA4CvC,OAAO,CAAC,kBAAkB;YAiBZ,gBAAgB;YA6HhB,2BAA2B;YAiE3B,2BAA2B;IAyEnC,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;IA0BpB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAuBhC"}

package/dist/mcp/server.js

@@ -556,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':
@@ -566,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':
@@ -847,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();
@@ -933,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;
         }
@@ -1060,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,
@@ -1083,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) {
@@ -1097,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,
@@ -1109,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();
@@ -1363,11 +1442,11 @@ 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;
@@ -1418,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;
     }
@@ -1463,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;