@path58/n8n-mcp 0.1.0

package/dist/mcp/adapters/validation.js

@@ -0,0 +1,258 @@
+/**
+ * MCP Validation Adapter - Bridges MCP tools to L1-L6 validation pipeline.
+ *
+ * Provides a unified interface for running the full validation pipeline
+ * and transforming results into MCP-compatible response format.
+ *
+ * @module mcp/adapters/validation
+ */
+import { validateL1Structure, validateL2Nodes, validateL3Credentials, validateL4Connections, validateL5Parameters, validateL6Patterns, } from '../../validation/index.js';
+import { loadL6CatalogCache } from '../../validation/l6-patterns.js';
+/**
+ * Transform L1-L6 errors into unified issue format.
+ */
+function transformError(error, level) {
+    return {
+        level,
+        severity: 'error',
+        code: error.code,
+        message: error.message,
+        location: {
+            node_name: error.node_name,
+            node_type: error.node_type,
+            path: error.path,
+        },
+    };
+}
+/**
+ * Transform L6 errors with suggested fixes.
+ */
+function transformL6Error(error) {
+    const issue = {
+        level: 6,
+        severity: error.severity || 'error',
+        code: error.code,
+        message: error.message,
+        location: {
+            node_name: error.node_name,
+            node_type: error.node_type,
+            path: error.path,
+        },
+    };
+    if (error.suggested_fix) {
+        issue.fix = {
+            action: error.suggested_fix.fix_type,
+            target: error.suggested_fix.target_node,
+            explanation: error.suggested_fix.description,
+        };
+    }
+    return issue;
+}
+/**
+ * Transform L6 warnings into unified issue format.
+ */
+function transformL6Warning(warning) {
+    const issue = {
+        level: 6,
+        severity: 'warning',
+        code: warning.code,
+        message: warning.message,
+        location: {
+            node_name: warning.node_name,
+            node_type: warning.node_type,
+        },
+    };
+    if (warning.suggested_fix) {
+        issue.fix = {
+            action: warning.suggested_fix.fix_type,
+            target: warning.suggested_fix.target_node,
+            explanation: warning.suggested_fix.description,
+        };
+    }
+    return issue;
+}
+/**
+ * Transform L2 warnings (deprecated nodes).
+ */
+function transformL2Warning(warning) {
+    return {
+        level: 2,
+        severity: 'warning',
+        code: warning.code,
+        message: warning.message,
+        location: {
+            node_name: warning.node_name,
+            node_type: warning.node_type,
+        },
+    };
+}
+/**
+ * Transform L3 warnings (OAuth detection, missing fields).
+ */
+function transformL3Warning(warning) {
+    return {
+        level: 3,
+        severity: 'warning',
+        code: warning.code,
+        message: warning.message,
+        location: {
+            node_name: warning.node_name,
+            node_type: warning.credential_type,
+        },
+    };
+}
+/**
+ * Transform L4 warnings (unknown connection patterns).
+ */
+function transformL4Warning(warning) {
+    return {
+        level: 4,
+        severity: 'warning',
+        code: warning.code,
+        message: warning.message,
+        location: {
+            node_type: warning.source_type,
+        },
+    };
+}
+/**
+ * Transform L5 warnings (unknown operations/parameters).
+ */
+function transformL5Warning(warning) {
+    return {
+        level: 5,
+        severity: 'warning',
+        code: warning.code,
+        message: warning.message,
+        location: {
+            node_name: warning.node_name,
+            node_type: warning.node_type,
+            parameter: warning.field,
+        },
+    };
+}
+/**
+ * Run the full L1-L6 validation pipeline.
+ *
+ * Executes validators in sequence (L1 → L6), stopping early on critical errors.
+ * Returns a unified response with all issues and summary statistics.
+ *
+ * @param workflowJson - Raw workflow JSON string to validate
+ * @param options - Validation options (max_level)
+ * @returns Unified validation response
+ */
+export async function runValidationPipeline(workflowJson, options) {
+    const startTime = performance.now();
+    const maxLevel = options?.max_level ?? 6;
+    const issues = [];
+    let levelReached = 0;
+    // ----------------------------------------------------------------
+    // L1: Structure Validation
+    // ----------------------------------------------------------------
+    const l1Result = await validateL1Structure(workflowJson);
+    levelReached = 1;
+    for (const error of l1Result.errors) {
+        issues.push(transformError(error, 1));
+    }
+    // L1 failures are critical - cannot proceed without valid structure
+    if (!l1Result.passed || maxLevel === 1) {
+        return buildResponse(l1Result.passed && maxLevel === 1, levelReached, issues, startTime);
+    }
+    // Parse workflow for subsequent validators
+    const workflow = JSON.parse(workflowJson);
+    // ----------------------------------------------------------------
+    // L2: Node Catalog Validation
+    // ----------------------------------------------------------------
+    const l2Result = await validateL2Nodes(workflow);
+    levelReached = 2;
+    for (const error of l2Result.errors) {
+        issues.push(transformError(error, 2));
+    }
+    for (const warning of l2Result.warnings || []) {
+        issues.push(transformL2Warning(warning));
+    }
+    if (!l2Result.passed || maxLevel === 2) {
+        return buildResponse(l2Result.passed && maxLevel === 2, levelReached, issues, startTime);
+    }
+    // ----------------------------------------------------------------
+    // L3: Credential Validation
+    // ----------------------------------------------------------------
+    const l3Result = await validateL3Credentials(workflow);
+    levelReached = 3;
+    for (const error of l3Result.errors) {
+        issues.push(transformError(error, 3));
+    }
+    for (const warning of l3Result.warnings || []) {
+        issues.push(transformL3Warning(warning));
+    }
+    if (!l3Result.passed || maxLevel === 3) {
+        return buildResponse(l3Result.passed && maxLevel === 3, levelReached, issues, startTime);
+    }
+    // ----------------------------------------------------------------
+    // L4: Connection Validation
+    // ----------------------------------------------------------------
+    const l4Result = await validateL4Connections(workflow);
+    levelReached = 4;
+    for (const error of l4Result.errors) {
+        issues.push(transformError(error, 4));
+    }
+    for (const warning of l4Result.warnings || []) {
+        issues.push(transformL4Warning(warning));
+    }
+    if (!l4Result.passed || maxLevel === 4) {
+        return buildResponse(l4Result.passed && maxLevel === 4, levelReached, issues, startTime);
+    }
+    // ----------------------------------------------------------------
+    // L5: Parameter Validation
+    // ----------------------------------------------------------------
+    const l5Result = await validateL5Parameters(workflow);
+    levelReached = 5;
+    for (const error of l5Result.errors) {
+        issues.push(transformError(error, 5));
+    }
+    for (const warning of l5Result.warnings || []) {
+        issues.push(transformL5Warning(warning));
+    }
+    if (!l5Result.passed || maxLevel === 5) {
+        return buildResponse(l5Result.passed && maxLevel === 5, levelReached, issues, startTime);
+    }
+    // ----------------------------------------------------------------
+    // L6: Pattern Validation
+    // ----------------------------------------------------------------
+    const l6CatalogCache = await loadL6CatalogCache();
+    const l6Result = await validateL6Patterns(workflow, l6CatalogCache);
+    levelReached = 6;
+    for (const error of l6Result.errors) {
+        issues.push(transformL6Error(error));
+    }
+    for (const warning of l6Result.warnings || []) {
+        issues.push(transformL6Warning(warning));
+    }
+    return buildResponse(l6Result.passed, levelReached, issues, startTime);
+}
+/**
+ * Build the final validation response.
+ */
+function buildResponse(valid, levelReached, issues, startTime) {
+    const errors = issues.filter((i) => i.severity === 'error').length;
+    const warnings = issues.filter((i) => i.severity === 'warning').length;
+    return {
+        valid,
+        level_reached: levelReached,
+        issues,
+        summary: {
+            total_issues: issues.length,
+            errors,
+            warnings,
+            validation_time_ms: Math.round(performance.now() - startTime),
+        },
+    };
+}
+/**
+ * Dispose of adapter resources (for cleanup).
+ */
+export async function disposeValidationAdapter() {
+    // Validators manage their own caching internally
+    // Nothing to dispose at the adapter level
+}
+//# sourceMappingURL=validation.js.map

package/dist/mcp/adapters/validation.js.map

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

package/dist/mcp/build-email-workflow.js

@@ -0,0 +1,113 @@
+/**
+ * Build and validate Gmail + Google Sheets workflow
+ */
+import { handleToolCall } from './tools/index.js';
+async function main() {
+    console.log('=== Building Gmail + Google Sheets Workflow ===\n');
+    // Build the workflow: Schedule -> Google Sheets -> Gmail
+    const workflow = {
+        name: 'Daily 8AM Email from Google Sheets',
+        nodes: [
+            {
+                id: 'schedule',
+                name: 'Schedule Trigger',
+                type: 'n8n-nodes-base.scheduleTrigger',
+                typeVersion: 1.2,
+                position: [0, 0],
+                parameters: {
+                    rule: {
+                        interval: [
+                            {
+                                field: 'cronExpression',
+                                expression: '0 8 * * *', // Every day at 8:00 AM
+                            },
+                        ],
+                    },
+                },
+            },
+            {
+                id: 'sheets',
+                name: 'Get Recipients',
+                type: 'n8n-nodes-base.googleSheets',
+                typeVersion: 4.5,
+                position: [220, 0],
+                parameters: {
+                    operation: 'read',
+                    documentId: {
+                        __rl: true,
+                        mode: 'list',
+                        value: '', // User needs to set this
+                    },
+                    sheetName: {
+                        __rl: true,
+                        mode: 'list',
+                        value: 'Sheet1',
+                    },
+                },
+                credentials: {
+                    googleSheetsOAuth2Api: {
+                        id: 'google-sheets-credential',
+                        name: 'Google Sheets OAuth2',
+                    },
+                },
+            },
+            {
+                id: 'gmail',
+                name: 'Send Email',
+                type: 'n8n-nodes-base.gmail',
+                typeVersion: 2.1,
+                position: [440, 0],
+                parameters: {
+                    operation: 'send',
+                    sendTo: '={{ $json.email }}', // Email column from sheets
+                    subject: 'Daily Update',
+                    emailType: 'text',
+                    message: '={{ $json.message || "Hello! This is your daily update." }}',
+                },
+                credentials: {
+                    gmailOAuth2: {
+                        id: 'gmail-credential',
+                        name: 'Gmail OAuth2',
+                    },
+                },
+            },
+        ],
+        connections: {
+            'Schedule Trigger': {
+                main: [[{ node: 'Get Recipients', type: 'main', index: 0 }]],
+            },
+            'Get Recipients': {
+                main: [[{ node: 'Send Email', type: 'main', index: 0 }]],
+            },
+        },
+    };
+    console.log('Workflow JSON:');
+    console.log(JSON.stringify(workflow, null, 2));
+    console.log('\n');
+    // Validate the workflow
+    console.log('=== Validating Workflow ===\n');
+    const result = await handleToolCall('validate_workflow', {
+        workflow: JSON.stringify(workflow),
+    });
+    const response = JSON.parse(result.content[0].text);
+    console.log('Validation Result:');
+    console.log(JSON.stringify(response, null, 2));
+    if (response.data?.issues?.length > 0) {
+        console.log('\n=== Getting Fix Suggestions ===\n');
+        for (const issue of response.data.issues.slice(0, 3)) {
+            console.log(`Issue: ${issue.code} - ${issue.message}`);
+            const fix = await handleToolCall('suggest_fix', {
+                issue_code: issue.code,
+                context: {
+                    node_type: issue.node_type || 'n8n-nodes-base.gmail',
+                    operation: issue.operation,
+                    parameter_name: issue.parameter_name,
+                },
+            });
+            console.log('Fix:', fix.content[0].text);
+            console.log('---');
+        }
+    }
+}
+main().catch(console.error);
+//# sourceMappingURL=build-email-workflow.js.map

package/dist/mcp/build-email-workflow.js.map

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

package/dist/mcp/config.js

@@ -0,0 +1,22 @@
+/**
+ * Configuration for the n8n-validator MCP server.
+ *
+ * @module mcp/config
+ */
+/**
+ * Server configuration constants and environment variables.
+ */
+export const config = {
+    // Server identity
+    SERVER_NAME: 'p58-n8n',
+    SERVER_VERSION: '0.1.0',
+    // Database configuration (from environment)
+    SUPABASE_URL: process.env.SUPABASE_URL,
+    SUPABASE_KEY: process.env.SUPABASE_KEY,
+    // Redis cache configuration
+    REDIS_URL: process.env.REDIS_URL,
+    // Performance settings
+    VALIDATION_TIMEOUT_MS: 5000,
+    CACHE_TTL_MS: 60000,
+};
+//# sourceMappingURL=config.js.map

package/dist/mcp/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/mcp/config.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,kBAAkB;IAClB,WAAW,EAAE,SAAS;IACtB,cAAc,EAAE,OAAO;IAEvB,4CAA4C;IAC5C,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;IACtC,YAAY,EAAE,OAAO,CAAC,GAAG,CAAC,YAAY;IAEtC,4BAA4B;IAC5B,SAAS,EAAE,OAAO,CAAC,GAAG,CAAC,SAAS;IAEhC,uBAAuB;IACvB,qBAAqB,EAAE,IAAI;IAC3B,YAAY,EAAE,KAAK;CACX,CAAC"}

package/dist/mcp/formatters/errors.js

@@ -0,0 +1,217 @@
+/**
+ * Error taxonomy and safe error factory for the MCP server.
+ * Ensures errors NEVER expose internal paths, stack traces, or sensitive information in production.
+ *
+ * @module mcp/formatters/errors
+ */
+/**
+ * Error code definitions with retry guidance.
+ */
+const ERROR_METADATA = {
+    INVALID_INPUT: {
+        retryable: false,
+        userGuidance: 'Fix input format',
+        safeMessage: 'Invalid input provided',
+    },
+    NOT_FOUND: {
+        retryable: false,
+        userGuidance: 'Check node/operation name',
+        safeMessage: 'Requested resource not found',
+    },
+    VALIDATION_ERROR: {
+        retryable: false,
+        userGuidance: 'Review validation issues and fix workflow',
+        safeMessage: 'Workflow validation found issues',
+    },
+    TIMEOUT: {
+        retryable: true,
+        userGuidance: 'Simplify request or try again',
+        safeMessage: 'Operation timed out',
+    },
+    RATE_LIMITED: {
+        retryable: true,
+        userGuidance: 'Wait and retry',
+        safeMessage: 'Too many requests, please wait',
+    },
+    INTERNAL_ERROR: {
+        retryable: true,
+        userGuidance: 'Contact support if persists',
+        safeMessage: 'An internal error occurred',
+    },
+    UNAVAILABLE: {
+        retryable: true,
+        userGuidance: 'Service temporarily unavailable, try again later',
+        safeMessage: 'Service temporarily unavailable',
+    },
+};
+/**
+ * Check if the current environment is production.
+ */
+function isProduction() {
+    return process.env.NODE_ENV === 'production';
+}
+/**
+ * Get the safe user-facing message for an error code.
+ */
+function getSafeMessage(code) {
+    return ERROR_METADATA[code].safeMessage;
+}
+/**
+ * Determine if an error code represents a retryable error.
+ */
+function isRetryable(code) {
+    return ERROR_METADATA[code].retryable;
+}
+/**
+ * Get user guidance for an error code.
+ */
+export function getUserGuidance(code) {
+    return ERROR_METADATA[code].userGuidance;
+}
+/**
+ * Default retry delay for retryable errors (5 seconds).
+ */
+const DEFAULT_RETRY_DELAY_MS = 5000;
+/**
+ * Retry delays by error code (overrides default).
+ */
+const RETRY_DELAYS = {
+    RATE_LIMITED: 30000,
+    TIMEOUT: 10000,
+    UNAVAILABLE: 15000,
+};
+/**
+ * Get the retry delay for an error code.
+ */
+function getRetryDelay(code) {
+    if (!isRetryable(code)) {
+        return undefined;
+    }
+    return RETRY_DELAYS[code] ?? DEFAULT_RETRY_DELAY_MS;
+}
+/**
+ * Sanitize error details to remove sensitive information.
+ * In production: returns undefined (no details exposed).
+ * In development: returns a hint from the original error.
+ */
+function sanitizeDetails(originalError, customDetails) {
+    if (isProduction()) {
+        return undefined;
+    }
+    // In development, provide helpful hints
+    if (customDetails !== undefined) {
+        return customDetails;
+    }
+    if (originalError) {
+        return { hint: originalError.message };
+    }
+    return undefined;
+}
+/**
+ * Create a safe error response that never exposes internal details in production.
+ *
+ * @param code - Error code from the taxonomy
+ * @param correlationId - Request correlation ID
+ * @param originalError - The original error (optional)
+ * @param customDetails - Custom details to include (dev only)
+ * @returns Safe error response
+ */
+export function createSafeError(code, correlationId, originalError, customDetails) {
+    const retryDelayMs = getRetryDelay(code);
+    return {
+        success: false,
+        correlation_id: correlationId,
+        error: {
+            code,
+            message: getSafeMessage(code),
+            retryable: isRetryable(code),
+            ...(retryDelayMs !== undefined && { retry_after_ms: retryDelayMs }),
+            details: sanitizeDetails(originalError, customDetails),
+        },
+    };
+}
+/**
+ * Create an INVALID_INPUT error response.
+ */
+export function createInvalidInputError(correlationId, validationErrors) {
+    return createSafeError('INVALID_INPUT', correlationId, undefined, validationErrors);
+}
+/**
+ * Create a NOT_FOUND error response.
+ */
+export function createNotFoundError(correlationId, resourceType, resourceId) {
+    const details = resourceType && resourceId
+        ? { resource_type: resourceType, resource_id: resourceId }
+        : undefined;
+    return createSafeError('NOT_FOUND', correlationId, undefined, details);
+}
+/**
+ * Create a VALIDATION_ERROR response (workflow failed validation).
+ */
+export function createValidationError(correlationId, validationIssues) {
+    return createSafeError('VALIDATION_ERROR', correlationId, undefined, validationIssues);
+}
+/**
+ * Create a TIMEOUT error response.
+ */
+export function createTimeoutError(correlationId, operation) {
+    const details = operation ? { operation } : undefined;
+    return createSafeError('TIMEOUT', correlationId, undefined, details);
+}
+/**
+ * Create a RATE_LIMITED error response.
+ */
+export function createRateLimitedError(correlationId, retryAfterMs) {
+    const response = createSafeError('RATE_LIMITED', correlationId);
+    if (retryAfterMs !== undefined) {
+        response.error.retry_after_ms = retryAfterMs;
+    }
+    return response;
+}
+/**
+ * Create an INTERNAL_ERROR response from an unexpected error.
+ * NEVER exposes stack traces or internal paths.
+ */
+export function createInternalError(correlationId, originalError) {
+    return createSafeError('INTERNAL_ERROR', correlationId, originalError);
+}
+/**
+ * Create an UNAVAILABLE error response.
+ */
+export function createUnavailableError(correlationId, service) {
+    const details = service ? { service } : undefined;
+    return createSafeError('UNAVAILABLE', correlationId, undefined, details);
+}
+/**
+ * Map common error types to appropriate error codes.
+ */
+export function classifyError(error) {
+    if (error instanceof Error) {
+        const message = error.message.toLowerCase();
+        if (message.includes('timeout') || message.includes('timed out')) {
+            return 'TIMEOUT';
+        }
+        if (message.includes('rate limit') || message.includes('too many')) {
+            return 'RATE_LIMITED';
+        }
+        if (message.includes('not found') || message.includes('does not exist')) {
+            return 'NOT_FOUND';
+        }
+        if (message.includes('invalid') || message.includes('validation')) {
+            return 'INVALID_INPUT';
+        }
+        if (message.includes('unavailable') || message.includes('offline')) {
+            return 'UNAVAILABLE';
+        }
+    }
+    return 'INTERNAL_ERROR';
+}
+/**
+ * Create an appropriate error response by classifying the error.
+ */
+export function createErrorFromException(correlationId, error) {
+    const code = classifyError(error);
+    const originalError = error instanceof Error ? error : new Error(String(error));
+    return createSafeError(code, correlationId, originalError);
+}
+//# sourceMappingURL=errors.js.map

package/dist/mcp/formatters/errors.js.map

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

package/dist/mcp/formatters/index.js

@@ -0,0 +1,12 @@
+/**
+ * MCP Response Formatters
+ *
+ * Exports standardized response formatting and safe error handling utilities.
+ *
+ * @module mcp/formatters
+ */
+// Error types and factories
+export { createSafeError, createInvalidInputError, createNotFoundError, createValidationError, createTimeoutError, createRateLimitedError, createInternalError, createUnavailableError, createErrorFromException, classifyError, getUserGuidance, } from './errors.js';
+// Response types and utilities
+export { generateCorrelationId, createSuccessResponse, createSuccessResponseWithTiming, withResponseFormatting, isSuccessResponse, isErrorResponse, serializeResponse, toMCPResponse, mcpSuccess, mcpError, executeToolHandler, } from './response.js';
+//# sourceMappingURL=index.js.map

package/dist/mcp/formatters/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/mcp/formatters/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,4BAA4B;AAC5B,OAAO,EAGL,eAAe,EACf,uBAAuB,EACvB,mBAAmB,EACnB,qBAAqB,EACrB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,sBAAsB,EACtB,wBAAwB,EACxB,aAAa,EACb,eAAe,GAChB,MAAM,aAAa,CAAC;AAErB,+BAA+B;AAC/B,OAAO,EAKL,qBAAqB,EACrB,qBAAqB,EACrB,+BAA+B,EAC/B,sBAAsB,EACtB,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,aAAa,EACb,UAAU,EACV,QAAQ,EACR,kBAAkB,GACnB,MAAM,eAAe,CAAC"}