n8n-mcp 2.41.3 → 2.42.0

package/dist/mcp/server.d.ts

@@ -46,6 +46,7 @@ export declare class N8NDocumentationMCPServer {
     private getNodeDocumentation;
     private safeJsonParse;
     private getDatabaseStatistics;
+    private buildOperationsTree;
     private getNodeEssentials;
     private getNode;
     private handleInfoMode;
@@ -74,6 +75,8 @@ export declare class N8NDocumentationMCPServer {
     private listNodeTemplates;
     private getTemplate;
     private searchTemplates;
+    private workflowPatternsCache;
+    private getWorkflowPatterns;
     private getTemplatesForTask;
     private searchTemplatesByMetadata;
     private getTaskDescription;

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAmGnE,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;IACnD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAkB;gBAExB,eAAe,CAAC,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,gBAAgB;IA8GvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA+Cd,kBAAkB;YAiDlB,wBAAwB;IA0BtC,OAAO,CAAC,kBAAkB;YA6CZ,iBAAiB;IAa/B,OAAO,CAAC,eAAe,CAAkB;YAE3B,sBAAsB;IAgDpC,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,aAAa;IAiYrB,OAAO,CAAC,wBAAwB;IAoFhC,OAAO,CAAC,kBAAkB;IA0E1B,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,qBAAqB;IAiF7B,OAAO,CAAC,2BAA2B;YA8VrB,SAAS;YA2DT,WAAW;YAkFX,WAAW;YA0CX,cAAc;YA8Md,gBAAgB;IAqD9B,OAAO,CAAC,mBAAmB;IAwE3B,OAAO,CAAC,eAAe;YAsBT,eAAe;IA2L7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,uBAAuB;IA0D/B,OAAO,CAAC,iBAAiB;YAqFX,WAAW;YAgCX,oBAAoB;IAuFlC,OAAO,CAAC,aAAa;YAQP,qBAAqB;YAwDrB,iBAAiB;YAiKjB,OAAO;YAgDP,cAAc;YAwFd,iBAAiB;IAqC/B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,4BAA4B;YAKtB,oBAAoB;IAsDlC,OAAO,CAAC,gBAAgB;YAiBV,SAAS;YA6CT,kBAAkB;YAqElB,uBAAuB;YAsDvB,iBAAiB;IAqE/B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IA4D/B,OAAO,CAAC,wBAAwB;IAkChC,OAAO,CAAC,iBAAiB;YAoDX,mBAAmB;YAoEnB,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;CAgEhC"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"AA0CA,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAmGnE,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;IACnD,OAAO,CAAC,WAAW,CAAiC;IACpD,OAAO,CAAC,kBAAkB,CAA4B;IACtD,OAAO,CAAC,iBAAiB,CAAkB;IAC3C,OAAO,CAAC,aAAa,CAAoC;IACzD,OAAO,CAAC,UAAU,CAAkB;gBAExB,eAAe,CAAC,EAAE,eAAe,EAAE,WAAW,CAAC,EAAE,gBAAgB;IA8GvE,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA+Cd,kBAAkB;YAiDlB,wBAAwB;IA0BtC,OAAO,CAAC,kBAAkB;YA6CZ,iBAAiB;IAa/B,OAAO,CAAC,eAAe,CAAkB;YAE3B,sBAAsB;IAgDpC,OAAO,CAAC,gBAAgB;IAqCxB,OAAO,CAAC,aAAa;IAiYrB,OAAO,CAAC,wBAAwB;IAoFhC,OAAO,CAAC,kBAAkB;IA0E1B,OAAO,CAAC,uBAAuB;IAwB/B,OAAO,CAAC,qBAAqB;IAiF7B,OAAO,CAAC,2BAA2B;YAiWrB,SAAS;YA2DT,WAAW;YAkFX,WAAW;YA2CX,cAAc;YAuNd,gBAAgB;IAuE9B,OAAO,CAAC,mBAAmB;IAwE3B,OAAO,CAAC,eAAe;YAsBT,eAAe;IA4M7B,OAAO,CAAC,kBAAkB;IAQ1B,OAAO,CAAC,uBAAuB;IA0D/B,OAAO,CAAC,iBAAiB;YAqFX,WAAW;YAgCX,oBAAoB;IAuFlC,OAAO,CAAC,aAAa;YAQP,qBAAqB;IA4DnC,OAAO,CAAC,mBAAmB;YAyCb,iBAAiB;YAiKjB,OAAO;YAgDP,cAAc;YAwFd,iBAAiB;IAqC/B,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,iBAAiB;IA0BzB,OAAO,CAAC,eAAe;IAwCvB,OAAO,CAAC,kBAAkB;IAiC1B,OAAO,CAAC,aAAa;IAoCrB,OAAO,CAAC,0BAA0B;IAgClC,OAAO,CAAC,4BAA4B;YAKtB,oBAAoB;IAsDlC,OAAO,CAAC,gBAAgB;YAiBV,SAAS;YA6CT,kBAAkB;YAqElB,uBAAuB;YAsDvB,iBAAiB;IAqE/B,OAAO,CAAC,qBAAqB;IA8C7B,OAAO,CAAC,uBAAuB;IA4D/B,OAAO,CAAC,wBAAwB;IAkChC,OAAO,CAAC,iBAAiB;YAoDX,mBAAmB;YAoEnB,qBAAqB;IAS7B,OAAO,CAAC,SAAS,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;YAS9B,aAAa;YAcb,iBAAiB;YAoBjB,WAAW;YAwBX,eAAe;IAqB7B,OAAO,CAAC,qBAAqB,CASb;IAEhB,OAAO,CAAC,mBAAmB;YAgDb,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;CAgEhC"}

package/dist/mcp/server.js

@@ -86,6 +86,7 @@ class N8NDocumentationMCPServer {
         this.sharedDbState = null;
         this.isShutdown = false;
         this.dbHealthChecked = false;
+        this.workflowPatternsCache = null;
         this.instanceContext = instanceContext;
         this.earlyLogger = earlyLogger || null;
         const envDbPath = process.env.NODE_DB_PATH;
@@ -934,6 +935,7 @@ class N8NDocumentationMCPServer {
                 return this.searchNodes(args.query, limit, {
                     mode: args.mode,
                     includeExamples: args.includeExamples,
+                    includeOperations: args.includeOperations,
                     source: args.source
                 });
             case 'get_node':
@@ -1025,6 +1027,8 @@ class N8NDocumentationMCPServer {
                             requiredService: args.requiredService,
                             targetAudience: args.targetAudience
                         }, searchLimit, searchOffset);
+                    case 'patterns':
+                        return this.getWorkflowPatterns(args.task, searchLimit);
                     case 'keyword':
                     default:
                         if (!args.query) {
@@ -1273,7 +1277,7 @@ class N8NDocumentationMCPServer {
             return { query, results: [], totalCount: 0 };
         }
         if (mode === 'FUZZY') {
-            return this.searchNodesFuzzy(cleanedQuery, limit);
+            return this.searchNodesFuzzy(cleanedQuery, limit, { includeOperations: options?.includeOperations });
         }
         let ftsQuery;
         if (cleanedQuery.startsWith('"') && cleanedQuery.endsWith('"')) {
@@ -1341,7 +1345,7 @@ class N8NDocumentationMCPServer {
             const hasHttpRequest = scoredNodes.some(n => n.node_type === 'nodes-base.httpRequest');
             if (cleanedQuery.toLowerCase().includes('http') && !hasHttpRequest) {
                 logger_1.logger.debug('FTS missed HTTP Request node, augmenting with LIKE search');
-                return this.searchNodesLIKE(query, limit);
+                return this.searchNodesLIKE(query, limit, options);
             }
             const result = {
                 query,
@@ -1365,6 +1369,12 @@ class N8NDocumentationMCPServer {
                             nodeResult.npmDownloads = node.npm_downloads;
                         }
                     }
+                    if (options?.includeOperations) {
+                        const opsTree = this.buildOperationsTree(node.operations);
+                        if (opsTree) {
+                            nodeResult.operationsTree = opsTree;
+                        }
+                    }
                     return nodeResult;
                 }),
                 totalCount: scoredNodes.length
@@ -1415,7 +1425,7 @@ class N8NDocumentationMCPServer {
             return this.searchNodesLIKE(query, limit);
         }
     }
-    async searchNodesFuzzy(query, limit) {
+    async searchNodesFuzzy(query, limit, options) {
         if (!this.db)
             throw new Error('Database not initialized');
         const words = query.toLowerCase().split(/\s+/).filter(w => w.length > 0);
@@ -1443,14 +1453,23 @@ class N8NDocumentationMCPServer {
         return {
             query,
             mode: 'FUZZY',
-            results: matchingNodes.map(node => ({
-                nodeType: node.node_type,
-                workflowNodeType: (0, node_utils_1.getWorkflowNodeType)(node.package_name, node.node_type),
-                displayName: node.display_name,
-                description: node.description,
-                category: node.category,
-                package: node.package_name
-            })),
+            results: matchingNodes.map(node => {
+                const nodeResult = {
+                    nodeType: node.node_type,
+                    workflowNodeType: (0, node_utils_1.getWorkflowNodeType)(node.package_name, node.node_type),
+                    displayName: node.display_name,
+                    description: node.description,
+                    category: node.category,
+                    package: node.package_name
+                };
+                if (options?.includeOperations) {
+                    const opsTree = this.buildOperationsTree(node.operations);
+                    if (opsTree) {
+                        nodeResult.operationsTree = opsTree;
+                    }
+                }
+                return nodeResult;
+            }),
             totalCount: matchingNodes.length
         };
     }
@@ -1571,6 +1590,12 @@ class N8NDocumentationMCPServer {
                             nodeResult.npmDownloads = node.npm_downloads;
                         }
                     }
+                    if (options?.includeOperations) {
+                        const opsTree = this.buildOperationsTree(node.operations);
+                        if (opsTree) {
+                            nodeResult.operationsTree = opsTree;
+                        }
+                    }
                     return nodeResult;
                 }),
                 totalCount: rankedNodes.length
@@ -1638,6 +1663,12 @@ class N8NDocumentationMCPServer {
                         nodeResult.npmDownloads = node.npm_downloads;
                     }
                 }
+                if (options?.includeOperations) {
+                    const opsTree = this.buildOperationsTree(node.operations);
+                    if (opsTree) {
+                        nodeResult.operationsTree = opsTree;
+                    }
+                }
                 return nodeResult;
             }),
             totalCount: rankedNodes.length
@@ -1941,6 +1972,47 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             })),
         };
     }
+    buildOperationsTree(operationsRaw) {
+        if (!operationsRaw)
+            return undefined;
+        let ops;
+        if (typeof operationsRaw === 'string') {
+            try {
+                ops = JSON.parse(operationsRaw);
+            }
+            catch {
+                return undefined;
+            }
+        }
+        else if (Array.isArray(operationsRaw)) {
+            ops = operationsRaw;
+        }
+        else {
+            return undefined;
+        }
+        if (!Array.isArray(ops) || ops.length === 0)
+            return undefined;
+        const byResource = new Map();
+        for (const op of ops) {
+            const resource = op.resource || 'default';
+            const opName = op.name || op.operation;
+            if (!opName)
+                continue;
+            if (!byResource.has(resource)) {
+                byResource.set(resource, []);
+            }
+            const list = byResource.get(resource);
+            if (!list.includes(opName)) {
+                list.push(opName);
+            }
+        }
+        if (byResource.size === 0)
+            return undefined;
+        return Array.from(byResource.entries()).map(([resource, operations]) => ({
+            resource,
+            operations
+        }));
+    }
     async getNodeEssentials(nodeType, includeExamples) {
         await this.ensureInitialized();
         if (!this.repository)
@@ -2798,6 +2870,48 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             tip: `Found ${result.total} templates matching "${query}". Showing ${result.items.length}.`
         };
     }
+    getWorkflowPatterns(category, limit = 10) {
+        if (!this.workflowPatternsCache) {
+            try {
+                const patternsPath = path_1.default.join(__dirname, '..', '..', 'data', 'workflow-patterns.json');
+                if ((0, fs_1.existsSync)(patternsPath)) {
+                    this.workflowPatternsCache = JSON.parse((0, fs_1.readFileSync)(patternsPath, 'utf-8'));
+                }
+                else {
+                    return { error: 'Workflow patterns not generated yet. Run: npm run mine:patterns' };
+                }
+            }
+            catch (e) {
+                return { error: `Failed to load workflow patterns: ${e instanceof Error ? e.message : String(e)}` };
+            }
+        }
+        const patterns = this.workflowPatternsCache;
+        if (category) {
+            const categoryData = patterns.categories[category];
+            if (!categoryData) {
+                const available = Object.keys(patterns.categories);
+                return { error: `Unknown category "${category}". Available: ${available.join(', ')}` };
+            }
+            return {
+                category,
+                ...categoryData,
+                nodes: categoryData.nodes?.slice(0, limit),
+                commonChains: categoryData.commonChains?.slice(0, limit),
+            };
+        }
+        const overview = Object.entries(patterns.categories).map(([name, data]) => ({
+            category: name,
+            templateCount: data.templateCount,
+            pattern: data.pattern,
+            topNodes: data.nodes?.slice(0, 5).map(n => n.displayName || n.type),
+        }));
+        return {
+            templateCount: patterns.templateCount,
+            generatedAt: patterns.generatedAt,
+            categories: overview,
+            tip: 'Use search_templates({searchMode: "patterns", task: "category_name"}) for full pattern data with nodes, chains, and tips.',
+        };
+    }
     async getTemplatesForTask(task, limit = 10, offset = 0) {
         await this.ensureInitialized();
         if (!this.templateService)