n8n-mcp 2.47.11 → 2.47.13

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

@@ -1 +1 @@
-{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/mcp/server.ts"],"names":[],"mappings":"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"}

package/dist/mcp/server.js

@@ -48,6 +48,7 @@ const tools_n8n_manager_1 = require("./tools-n8n-manager");
 const tools_n8n_friendly_1 = require("./tools-n8n-friendly");
 const workflow_examples_1 = require("./workflow-examples");
 const logger_1 = require("../utils/logger");
+const redaction_1 = require("../utils/redaction");
 const node_repository_1 = require("../database/node-repository");
 const database_adapter_1 = require("../database/database-adapter");
 const shared_database_1 = require("../database/shared-database");
@@ -438,15 +439,11 @@ class N8NDocumentationMCPServer {
         });
         this.server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             const { name, arguments: args } = request.params;
-            logger_1.logger.info('Tool call received - DETAILED DEBUG', {
+            logger_1.logger.info('Tool call received', {
                 toolName: name,
-                arguments: JSON.stringify(args, null, 2),
-                argumentsType: typeof args,
-                argumentsKeys: args ? Object.keys(args) : [],
-                hasNodeType: args && 'nodeType' in args,
-                hasConfig: args && 'config' in args,
-                configType: args && args.config ? typeof args.config : 'N/A',
-                rawRequest: JSON.stringify(request.params)
+                ...(0, redaction_1.summarizeToolCallArgs)(args),
+                hasNodeType: !!(args && typeof args === 'object' && 'nodeType' in args),
+                hasConfig: !!(args && typeof args === 'object' && 'config' in args),
             });
             const disabledTools = this.getDisabledTools();
             if (disabledTools.has(name)) {
@@ -482,8 +479,9 @@ class N8NDocumentationMCPServer {
                         const parsed = JSON.parse(possibleNestedData);
                         if (parsed && typeof parsed === 'object') {
                             logger_1.logger.warn('Detected n8n nested output bug, attempting to extract actual arguments', {
-                                originalArgs: args,
-                                extractedArgs: parsed
+                                toolName: name,
+                                originalArgsKeys: Object.keys(args),
+                                extractedArgsKeys: Object.keys(parsed),
                             });
                             if (this.validateExtractedArgs(name, parsed)) {
                                 processedArgs = parsed;
@@ -491,7 +489,7 @@ class N8NDocumentationMCPServer {
                             else {
                                 logger_1.logger.warn('Extracted arguments failed validation, using original args', {
                                     toolName: name,
-                                    extractedArgs: parsed
+                                    extractedArgsKeys: Object.keys(parsed),
                                 });
                             }
                         }
@@ -508,7 +506,7 @@ class N8NDocumentationMCPServer {
                 processedArgs = JSON.parse(JSON.stringify(processedArgs));
             }
             try {
-                logger_1.logger.debug(`Executing tool: ${name}`, { args: processedArgs });
+                logger_1.logger.debug(`Executing tool: ${name}`, (0, redaction_1.summarizeToolCallArgs)(processedArgs));
                 const startTime = Date.now();
                 const result = await this.executeTool(name, processedArgs);
                 const duration = Date.now() - startTime;
@@ -800,8 +798,8 @@ class N8NDocumentationMCPServer {
             if (!(requiredField in args)) {
                 logger_1.logger.debug(`Extracted args missing required field: ${requiredField}`, {
                     toolName,
-                    extractedArgs: args,
-                    required
+                    extractedArgsKeys: Object.keys(args),
+                    required,
                 });
                 return false;
             }
@@ -818,7 +816,6 @@ class N8NDocumentationMCPServer {
                         toolName,
                         expectedType,
                         actualType,
-                        fieldValue
                     });
                     return false;
                 }
@@ -931,7 +928,7 @@ class N8NDocumentationMCPServer {
         }
         if (coercedAny) {
             logger_1.logger.warn(`Coerced mistyped params for tool "${toolName}"`, {
-                original: Object.fromEntries(Object.entries(args).map(([k, v]) => [k, `${typeof v}: ${typeof v === 'string' ? v.substring(0, 80) : v}`])),
+                original: Object.fromEntries(Object.entries(args).map(([k, v]) => [k, typeof v])),
             });
         }
         return coerced;
@@ -942,11 +939,7 @@ class N8NDocumentationMCPServer {
         if (disabledTools.has(name)) {
             throw new Error(`Tool '${name}' is disabled via DISABLED_TOOLS environment variable`);
         }
-        logger_1.logger.info(`Tool execution: ${name}`, {
-            args: typeof args === 'object' ? JSON.stringify(args) : args,
-            argsType: typeof args,
-            argsKeys: typeof args === 'object' ? Object.keys(args) : 'not-object'
-        });
+        logger_1.logger.info(`Tool execution: ${name}`, (0, redaction_1.summarizeToolCallArgs)(args));
         if (typeof args !== 'object' || args === null) {
             throw new Error(`Invalid arguments for tool ${name}: expected object, got ${typeof args}`);
         }
@@ -2308,18 +2301,34 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         }
         const versions = this.repository.getNodeVersions(nodeType);
         const latest = this.repository.getLatestNodeVersion(nodeType);
+        const nodeRow = latest ? null : this.repository.getNode(nodeType);
         const summary = {
-            currentVersion: latest?.version || 'unknown',
+            currentVersion: latest?.version ?? nodeRow?.version ?? 'unknown',
             totalVersions: versions.length,
             hasVersionHistory: versions.length > 0
         };
         this.cache.set(cacheKey, summary, 86400000);
         return summary;
     }
+    versionMetadataUnavailable(nodeType, extra = {}) {
+        const node = this.repository.getNode(nodeType);
+        return {
+            nodeType,
+            available: false,
+            reason: 'Version metadata not populated for this node. Callers must not infer upgrade safety from this response.',
+            currentVersion: node?.version ?? null,
+            isVersioned: node?.isVersioned ?? false,
+            ...extra
+        };
+    }
     getVersionHistory(nodeType) {
+        if (!this.repository.hasVersionMetadata(nodeType)) {
+            return this.versionMetadataUnavailable(nodeType, { totalVersions: 0, versions: [] });
+        }
         const versions = this.repository.getNodeVersions(nodeType);
         return {
             nodeType,
+            available: true,
             totalVersions: versions.length,
             versions: versions.map(v => ({
                 version: v.version,
@@ -2330,14 +2339,18 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
                 breakingChangesCount: (v.breakingChanges || []).length,
                 deprecatedProperties: v.deprecatedProperties || [],
                 addedProperties: v.addedProperties || []
-            })),
-            available: versions.length > 0,
-            message: versions.length === 0 ?
-                'No version history available. Version tracking may not be enabled for this node.' :
-                undefined
+            }))
         };
     }
     compareVersions(nodeType, fromVersion, toVersion) {
+        if (!this.repository.hasVersionMetadata(nodeType)) {
+            return this.versionMetadataUnavailable(nodeType, {
+                fromVersion,
+                toVersion: toVersion ?? 'latest',
+                totalChanges: 0,
+                changes: []
+            });
+        }
         const latest = this.repository.getLatestNodeVersion(nodeType);
         const targetVersion = toVersion || latest?.version;
         if (!targetVersion) {
@@ -2346,6 +2359,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         const changes = this.repository.getPropertyChanges(nodeType, fromVersion, targetVersion);
         return {
             nodeType,
+            available: true,
             fromVersion,
             toVersion: targetVersion,
             totalChanges: changes.length,
@@ -2363,9 +2377,18 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         };
     }
     getBreakingChanges(nodeType, fromVersion, toVersion) {
+        if (!this.repository.hasVersionMetadata(nodeType)) {
+            return this.versionMetadataUnavailable(nodeType, {
+                fromVersion,
+                toVersion: toVersion ?? 'latest',
+                totalBreakingChanges: 0,
+                changes: []
+            });
+        }
         const breakingChanges = this.repository.getBreakingChanges(nodeType, fromVersion, toVersion);
         return {
             nodeType,
+            available: true,
             fromVersion,
             toVersion: toVersion || 'latest',
             totalBreakingChanges: breakingChanges.length,
@@ -2383,10 +2406,20 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         };
     }
     getMigrations(nodeType, fromVersion, toVersion) {
+        if (!this.repository.hasVersionMetadata(nodeType)) {
+            return this.versionMetadataUnavailable(nodeType, {
+                fromVersion,
+                toVersion,
+                autoMigratableChanges: 0,
+                totalChanges: 0,
+                migrations: []
+            });
+        }
         const migrations = this.repository.getAutoMigratableChanges(nodeType, fromVersion, toVersion);
         const allChanges = this.repository.getPropertyChanges(nodeType, fromVersion, toVersion);
         return {
             nodeType,
+            available: true,
             fromVersion,
             toVersion,
             autoMigratableChanges: migrations.length,
@@ -3021,6 +3054,21 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         await this.ensureInitialized();
         if (!this.templateService)
             throw new Error('Template service not initialized');
+        const metadataAvailable = await this.templateService.hasMetadataCoverage();
+        if (!metadataAvailable) {
+            return {
+                available: false,
+                reason: 'Template metadata has not been enriched yet. by_metadata search requires ' +
+                    'running the metadata enrichment job (see scripts/fetch-templates). ' +
+                    'Use searchMode "keyword", "by_nodes", or "patterns" in the meantime.',
+                filters,
+                items: [],
+                total: 0,
+                limit,
+                offset,
+                hasMore: false
+            };
+        }
         const result = await this.templateService.searchTemplatesByMetadata(filters, limit, offset);
         const filterSummary = [];
         if (filters.category)
@@ -3040,6 +3088,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
             const availableAudiences = await this.templateService.getAvailableTargetAudiences();
             return {
                 ...result,
+                available: true,
                 message: `No templates found with filters: ${filterSummary.join(', ')}`,
                 availableCategories: availableCategories.slice(0, 10),
                 availableAudiences: availableAudiences.slice(0, 5),
@@ -3048,6 +3097,7 @@ Full documentation is being prepared. For now, use get_node_essentials for confi
         }
         return {
             ...result,
+            available: true,
             filters,
             filterSummary: filterSummary.join(', '),
             tip: `Found ${result.total} templates matching filters. Showing ${result.items.length}. Each includes AI-generated metadata.`