n8n-workflow-builder-mcp 1.0.2 → 2.0.0

package/README.md

@@ -155,20 +155,55 @@ Alternatively, you can set up the MCP server through Cursor's interface:
 
 The server provides the following tools for working with n8n workflows:
 
+### Core Workflow Management
+
 | Tool Name | Description | Key Parameters |
 |-----------|-------------|----------------|
 | **create_workflow** | Create a new n8n workflow | `workflow_name`, `workspace_dir` |
 | **list_workflows** | List workflows in the workspace | `limit` (optional), `cursor` (optional) |
 | **get_workflow_details** | Get detailed information about a specific workflow | `workflow_name`, `workflow_path` (optional) |
+| **validate_workflow** | Validate a workflow file against node schemas and connectivity | `workflow_name`, `workflow_path` (optional) |
+
+### Node Management
+
+| Tool Name | Description | Key Parameters |
+|-----------|-------------|----------------|
 | **add_node** | Add a new node to a workflow | `workflow_name`, `node_type`, `position` (optional), `parameters` (optional), `node_name` (optional), `typeVersion` (optional), `webhookId` (optional), `workflow_path` (optional), `connect_from` (optional), `connect_to` (optional) |
 | **edit_node** | Edit an existing node in a workflow | `workflow_name`, `node_id`, `node_type` (optional), `node_name` (optional), `position` (optional), `parameters` (optional), `typeVersion` (optional), `webhookId` (optional), `workflow_path` (optional), `connect_from` (optional), `connect_to` (optional) |
 | **delete_node** | Delete a node from a workflow | `workflow_name`, `node_id`, `workflow_path` (optional) |
+| **list_available_nodes** | List available node types with optional filtering. Supports tag-style synonyms and multi-token OR/AND logic | `search_term` (optional), `n8n_version` (optional), `limit` (optional), `cursor` (optional), `tags` (optional, default: true), `token_logic` (optional: 'or' default, or 'and') |
+
+### Connection Management
+
+| Tool Name | Description | Key Parameters |
+|-----------|-------------|----------------|
 | **add_connection** | Create a connection between two nodes | `workflow_name`, `source_node_id`, `source_node_output_name`, `target_node_id`, `target_node_input_name`, `target_node_input_index` (optional), `workflow_path` (optional) |
 | **add_ai_connections** | Wire AI model, tools, and memory to an agent | `workflow_name`, `agent_node_id`, `model_node_id` (optional), `tool_node_ids` (optional), `memory_node_id` (optional), `embeddings_node_id` (optional), `vector_store_node_id` (optional), `vector_insert_node_id` (optional), `vector_tool_node_id` (optional), `workflow_path` (optional) |
+| **connect_main_chain** | Build a minimal main path through AI workflow nodes (Trigger → Model → Memory → Embeddings → Doc Loader → Vector Store → Vector Tool → Agent) | `workflow_name`, `workflow_path` (optional), `dry_run` (optional), `idempotency_key` (optional) |
+
+### Workflow Planning & Composition
+
+| Tool Name | Description | Key Parameters |
+|-----------|-------------|----------------|
+| **plan_workflow** | Create a non-destructive plan (nodes and connections) to update a workflow. Does not write files | `workflow_name`, `target` (nodes, connections), `workspace_dir` (optional) |
+| **review_workflow_plan** | Apply a plan in-memory and return validation errors, warnings, and suggested fixes. Does not write files | `workflow_name`, `plan`, `workflow_path` (optional) |
+| **apply_workflow_plan** | Apply a previously reviewed plan to the workflow on disk (atomic write) | `workflow_name`, `plan`, `workflow_path` (optional) |
 | **compose_ai_workflow** | Compose a complex AI workflow (agent + model + memory + embeddings + vector + tools + trigger) in one call, including wiring and basic validation | `workflow_name`, `plan`, `n8n_version` (optional) |
-| **list_available_nodes** | List available node types with optional filtering. Supports tag-style synonyms and multi-token OR/AND logic | `search_term` (optional), `n8n_version` (optional), `limit` (optional), `cursor` (optional), `tags` (optional, default: true), `token_logic` (optional: 'or' default, or 'and') |
+
+### Parameter Management
+
+| Tool Name | Description | Key Parameters |
+|-----------|-------------|----------------|
+| **suggest_node_params** | Suggest minimal valid parameters for a node type using defaults and required fields | `node_type`, `typeVersion` (optional), `existing_parameters` (optional) |
+| **list_missing_parameters** | List required parameters missing for a node considering visibility rules | `node_type`, `typeVersion` (optional), `parameters` |
+| **fix_node_params** | Return parameters with defaults applied for required fields that are missing | `node_type`, `typeVersion` (optional), `parameters` (optional) |
+
+### Templates & Discovery
+
+| Tool Name | Description | Key Parameters |
+|-----------|-------------|----------------|
+| **list_template_examples** | List node usage examples extracted from free templates. Filter by node_type or template_name | `node_type` (optional), `template_name` (optional), `limit` (optional), `cursor` (optional) |
 | **get_n8n_version_info** | Get current N8N version and capabilities | `random_string` |
-| **validate_workflow** | Validate a workflow file against node schemas and connectivity | `workflow_name`, `workflow_path` (optional) |
 
 ### Validation behavior
 

package/dist/index.js

@@ -209,7 +209,7 @@ server.tool("create_workflow", "Create a new n8n workflow", createWorkflowParams
             id: (0, id_1.generateN8nId)(), // e.g., "Y6sBMxxyJQtgCCBQ"
             nodes: [], // Initialize with empty nodes array
             connections: {}, // Initialize with empty connections object
-            active: false,
+            ...(0, versioning_1.workflowActivationDefaults)(),
             pinData: {},
             settings: {
                 executionOrder: "v1"
@@ -220,9 +220,7 @@ server.tool("create_workflow", "Create a new n8n workflow", createWorkflowParams
             },
             tags: []
         };
-        // Sanitize workflowName for filename or ensure it's safe.
-        // For now, using directly. Consider a sanitization function for production.
-        const filename = `${workflowName.replace(/[^a-z0-9_.-]/gi, '_')}.json`;
+        const filename = `${(0, workspace_1.sanitizeFilename)(workflowName)}.json`;
         const filePath = (0, workspace_1.resolvePath)(path_1.default.join(workspace_1.WORKFLOW_DATA_DIR_NAME, filename));
         await promises_1.default.writeFile(filePath, JSON.stringify(newN8nWorkflow, null, 2));
         console.error("[DEBUG] Workflow created and saved to:", filePath);
@@ -394,6 +392,15 @@ server.tool("add_node", "Add a node to an n8n workflow", addNodeParamsSchema.sha
         // Normalize the node type and resolve to a compatible typeVersion automatically
         const { finalNodeType, finalTypeVersion } = (0, cache_1.normalizeNodeTypeAndVersion)(params.node_type, params.typeVersion);
         let resolvedVersion = finalTypeVersion;
+        const addNodeWarnings = [];
+        // Check if the node type exists in the loaded catalog at all
+        const knownInCatalog = (0, cache_1.getNodeInfoCache)().has(params.node_type.toLowerCase())
+            || (0, cache_1.getNodeInfoCache)().has(finalNodeType.toLowerCase())
+            || ((0, versioning_1.getN8nVersionInfo)()?.supportedNodes.has(finalNodeType) ?? false);
+        if (!knownInCatalog) {
+            addNodeWarnings.push(`Node type '${finalNodeType}' was not found in the n8n ${(0, versioning_1.getCurrentN8nVersion)() || 'unknown'} node catalog. ` +
+                `The node will be added but may not be valid. Use 'list_available_nodes' to find valid node types.`);
+        }
         // Check if node type is supported in current N8N version
         if (!(0, cache_1.isNodeTypeSupported)(finalNodeType, finalTypeVersion)) {
             // Auto-heal: if the chosen version is not supported, try to downgrade to the highest supported one
@@ -586,11 +593,11 @@ server.tool("add_node", "Add a node to an n8n workflow", addNodeParamsSchema.sha
                 return { ok, errors: nodeErrors, warnings: nodeWarnings, nodeIssues };
             };
             const local = buildLocalValidation(report, newNode.name);
-            return { content: [{ type: "text", text: JSON.stringify({ success: true, node: newNode, workflowId: workflow.id, createdConnections, localValidation: local }) }] };
+            return { content: [{ type: "text", text: JSON.stringify({ success: true, node: newNode, workflowId: workflow.id, createdConnections, localValidation: local, ...(addNodeWarnings.length > 0 ? { warnings: addNodeWarnings } : {}) }) }] };
         }
         catch (e) {
             console.warn('[WARN] Validation step errored after add_node:', e?.message || e);
-            return { content: [{ type: "text", text: JSON.stringify({ success: true, node: newNode, workflowId: workflow.id, createdConnections }) }] };
+            return { content: [{ type: "text", text: JSON.stringify({ success: true, node: newNode, workflowId: workflow.id, createdConnections, ...(addNodeWarnings.length > 0 ? { warnings: addNodeWarnings } : {}) }) }] };
         }
     }
     catch (error) {
@@ -1490,7 +1497,7 @@ server.tool("compose_ai_workflow", "Compose a complex AI workflow (agent + model
     try {
         // Step 1: ensure workflow exists (create if missing)
         await (0, workspace_1.ensureWorkflowDir)();
-        const filePath = (0, workspace_1.resolvePath)(path_1.default.join(workspace_1.WORKFLOW_DATA_DIR_NAME, `${workflow_name.replace(/[^a-z0-9_.-]/gi, '_')}.json`));
+        const filePath = (0, workspace_1.resolvePath)(path_1.default.join(workspace_1.WORKFLOW_DATA_DIR_NAME, `${(0, workspace_1.sanitizeFilename)(workflow_name)}.json`));
         let workflow;
         try {
             const raw = await promises_1.default.readFile(filePath, 'utf8');
@@ -1498,10 +1505,14 @@ server.tool("compose_ai_workflow", "Compose a complex AI workflow (agent + model
         }
         catch (e) {
             // Create minimal workflow if missing
-            workflow = { name: workflow_name, id: (0, id_1.generateUUID)(), nodes: [], connections: {}, active: false, pinData: {}, settings: { executionOrder: 'v1' }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateUUID)() }, tags: [] };
+            workflow = { name: workflow_name, id: (0, id_1.generateUUID)(), nodes: [], connections: {}, ...(0, versioning_1.workflowActivationDefaults)(), pinData: {}, settings: { executionOrder: 'v1' }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateUUID)() }, tags: [] };
         }
-        // Helper to add a node with normalization
+        // Helper to add a node with normalization. Idempotent: if a node with
+        // the same name exists, return it instead of duplicating.
         const addNode = async (nodeType, nodeName, parameters, position) => {
+            const existing = workflow.nodes.find(n => n.name === nodeName);
+            if (existing)
+                return existing;
             const { finalNodeType, finalTypeVersion } = (0, cache_1.normalizeNodeTypeAndVersion)(nodeType);
             const node = {
                 id: (0, id_1.generateN8nId)(),
@@ -1530,11 +1541,19 @@ server.tool("compose_ai_workflow", "Compose a complex AI workflow (agent + model
         const vtool = plan.vector_tool ? await addNode(plan.vector_tool.node_type, plan.vector_tool.node_name, plan.vector_tool.parameters, positions.vtool) : null;
         const extraTools = [];
         if (Array.isArray(plan.tools)) {
-            for (const t of plan.tools)
-                extraTools.push(await addNode(t.node_type, t.node_name || t.node_type.split('.').pop() || 'Tool', t.parameters));
+            let toolX = 640;
+            for (const t of plan.tools) {
+                extraTools.push(await addNode(t.node_type, t.node_name || t.node_type.split('.').pop() || 'Tool', t.parameters, { x: toolX, y: 240 }));
+                toolX += 200;
+            }
+        }
+        // Auto-create toolVectorStore bridge when vector_store exists but vector_tool wasn't provided
+        let effectiveVtool = vtool;
+        if (vstore && !vtool && agent) {
+            effectiveVtool = await addNode('@n8n/n8n-nodes-langchain.toolVectorStore', 'Vector Store Tool', undefined, positions.vtool);
         }
         // Step 3: wire standard connections
-        const toolIds = [...(vtool ? [vtool.id] : []), ...extraTools.map(t => t.id)];
+        const toolIds = [...(effectiveVtool ? [effectiveVtool.id] : []), ...extraTools.map(t => t.id)];
         await promises_1.default.writeFile(filePath, JSON.stringify(workflow, null, 2));
         // Re-load to use shared connection routine
         const res = await (async () => {
@@ -1595,9 +1614,13 @@ server.tool("compose_ai_workflow", "Compose a complex AI workflow (agent + model
             await connect(memory, 'ai_memory', agent, 'ai_memory');
             await connect(embeddings, 'ai_embeddings', vstore, 'ai_embeddings');
             await connect(vstore, 'ai_document', vinsert, 'ai_document');
-            await connect(vstore, 'ai_vectorStore', vtool, 'ai_vectorStore');
-            await connect(model, 'ai_languageModel', vtool, 'ai_languageModel');
-            await connect(vtool, 'ai_tool', agent, 'ai_tool');
+            await connect(vstore, 'ai_vectorStore', effectiveVtool, 'ai_vectorStore');
+            await connect(model, 'ai_languageModel', effectiveVtool, 'ai_languageModel');
+            await connect(effectiveVtool, 'ai_tool', agent, 'ai_tool');
+            // Wire extra tools (from plan.tools[]) to agent
+            for (const tool of extraTools) {
+                await connect(tool, 'ai_tool', agent, 'ai_tool');
+            }
             await connect(trigger, 'main', agent, 'main');
             return { success: true };
         })();
@@ -2123,9 +2146,9 @@ server.tool("validate_workflow", "Validate a workflow file against known node sc
                         }
                     }
                 }
-                // Always strict now; multiple chains are not allowed
-                const strictMainOnly = true;
-                const targetSet = strictMainOnly ? reachableMain : reachableExtended;
+                // Use extended reachability: nodes attached via AI handles (ai_languageModel,
+                // ai_memory, ai_embeddings, etc.) are considered part of the main chain.
+                const targetSet = reachableExtended;
                 // Any enabled node not in targetSet is disconnected from main chain → error
                 for (const [name, node] of Object.entries(nodesByName)) {
                     if (node.disabled === true)
@@ -2508,7 +2531,7 @@ server.tool("review_workflow_plan", "Apply a plan in-memory and return validatio
             id: (0, id_1.generateN8nId)(),
             nodes: [],
             connections: {},
-            active: false,
+            ...(0, versioning_1.workflowActivationDefaults)(),
             pinData: {},
             settings: { executionOrder: "v1" },
             versionId: (0, id_1.generateUUID)(),
@@ -2605,7 +2628,7 @@ server.tool("apply_workflow_plan", "Apply a previously reviewed plan to the work
                 id: (0, id_1.generateN8nId)(),
                 nodes: [],
                 connections: {},
-                active: false,
+                ...(0, versioning_1.workflowActivationDefaults)(),
                 pinData: {},
                 settings: { executionOrder: "v1" },
                 versionId: (0, id_1.generateUUID)(),
@@ -2707,7 +2730,7 @@ server.tool("list_missing_parameters", "List required parameters missing for a n
             id: (0, id_1.generateN8nId)(),
             nodes: [{ id: nodeId, name: nodeName, type: finalNodeType, typeVersion: finalTypeVersion, position: [200, 200], parameters: params.parameters }],
             connections: {},
-            active: false,
+            ...(0, versioning_1.workflowActivationDefaults)(),
             pinData: {},
             settings: { executionOrder: "v1" },
             versionId: (0, id_1.generateUUID)(),
@@ -2739,7 +2762,7 @@ server.tool("fix_node_params", "Return parameters with defaults applied for requ
         const nodeName = (finalNodeType.split('.').pop() || 'Node') + ' 1';
         const provisional = {
             name: 'tmp', id: (0, id_1.generateN8nId)(), nodes: [{ id: nodeId, name: nodeName, type: finalNodeType, typeVersion: finalTypeVersion, position: [200, 200], parameters: merged }],
-            connections: {}, active: false, pinData: {}, settings: { executionOrder: "v1" }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateInstanceId)() }, tags: []
+            connections: {}, ...(0, versioning_1.workflowActivationDefaults)(), pinData: {}, settings: { executionOrder: "v1" }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateInstanceId)() }, tags: []
         };
         const nodeTypes = await (0, nodeTypesLoader_1.loadNodeTypesForCurrentVersion)(path_1.default.resolve(__dirname, '../workflow_nodes'), (0, versioning_1.getCurrentN8nVersion)());
         const report = (0, workflowValidator_1.validateAndNormalizeWorkflow)(provisional, nodeTypes);

package/dist/mcp/tools/composeAiWorkflow.js

@@ -48,7 +48,7 @@ async function handler(params, _extra) {
     try {
         // Step 1: ensure workflow exists (create if missing)
         await (0, workspace_1.ensureWorkflowDir)();
-        const filePath = (0, workspace_1.resolvePath)(path_1.default.join(workspace_1.WORKFLOW_DATA_DIR_NAME, `${workflow_name.replace(/[^a-z0-9_.-]/gi, '_')}.json`));
+        const filePath = (0, workspace_1.resolveWorkflowPath)(workflow_name);
         let workflow;
         try {
             const raw = await promises_1.default.readFile(filePath, 'utf8');
@@ -56,10 +56,16 @@ async function handler(params, _extra) {
         }
         catch (e) {
             // Create minimal workflow if missing
-            workflow = { name: workflow_name, id: (0, id_1.generateUUID)(), nodes: [], connections: {}, active: false, pinData: {}, settings: { executionOrder: 'v1' }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateUUID)() }, tags: [] };
+            workflow = { name: workflow_name, id: (0, id_1.generateUUID)(), nodes: [], connections: {}, ...(0, versioning_1.workflowActivationDefaults)(), pinData: {}, settings: { executionOrder: 'v1' }, versionId: (0, id_1.generateUUID)(), meta: { instanceId: (0, id_1.generateUUID)() }, tags: [] };
         }
-        // Helper to add a node with normalization
+        // Helper to add a node with normalization. Idempotent: if a node with the
+        // same name already exists in the workflow, return it instead of creating a
+        // duplicate. This prevents triplication when compose is called multiple times
+        // on the same workflow (e.g., LLM retries).
         const addNode = async (nodeType, nodeName, parameters, position) => {
+            const existing = workflow.nodes.find(n => n.name === nodeName);
+            if (existing)
+                return existing;
             const { finalNodeType, finalTypeVersion } = (0, cache_1.normalizeNodeTypeAndVersion)(nodeType);
             const node = {
                 id: (0, id_1.generateN8nId)(),

package/dist/mcp/tools/createWorkflow.js

@@ -10,6 +10,7 @@ const promises_1 = __importDefault(require("fs/promises"));
 const path_1 = __importDefault(require("path"));
 const workspace_1 = require("../../utils/workspace");
 const id_1 = require("../../utils/id");
+const versioning_1 = require("../../nodes/versioning");
 const constants_1 = require("../../utils/constants");
 // Schema definition
 exports.paramsSchema = zod_1.z.object({
@@ -51,7 +52,7 @@ async function handler(params, _extra) {
             id: (0, id_1.generateN8nId)(), // e.g., "Y6sBMxxyJQtgCCBQ"
             nodes: [], // Initialize with empty nodes array
             connections: {}, // Initialize with empty connections object
-            active: false,
+            ...(0, versioning_1.workflowActivationDefaults)(),
             pinData: {},
             settings: {
                 executionOrder: "v1"
@@ -62,9 +63,7 @@ async function handler(params, _extra) {
             },
             tags: []
         };
-        // Sanitize workflowName for filename or ensure it's safe.
-        // For now, using directly. Consider a sanitization function for production.
-        const filename = `${workflowName.replace(/[^a-z0-9_.-]/gi, '_')}.json`;
+        const filename = `${(0, workspace_1.sanitizeFilename)(workflowName)}.json`;
         const filePath = (0, workspace_1.resolvePath)(path_1.default.join(workspace_1.WORKFLOW_DATA_DIR_NAME, filename));
         await promises_1.default.writeFile(filePath, JSON.stringify(newN8nWorkflow, null, 2));
         console.error("[DEBUG] Workflow created and saved to:", filePath);

package/dist/mcp/tools/validateWorkflow.js

@@ -179,9 +179,9 @@ async function handler(params, _extra) {
                         }
                     }
                 }
-                // Always strict now; multiple chains are not allowed
-                const strictMainOnly = true;
-                const targetSet = strictMainOnly ? reachableMain : reachableExtended;
+                // Use extended reachability: nodes attached via AI handles (ai_languageModel,
+                // ai_memory, ai_embeddings, etc.) are considered part of the main chain.
+                const targetSet = reachableExtended;
                 // Any enabled node not in targetSet is disconnected from main chain → error
                 for (const [name, node] of Object.entries(nodesByName)) {
                     if (node.disabled === true)

package/dist/nodes/cache.js

@@ -63,7 +63,9 @@ function normalizeNodeTypeAndVersion(inputType, inputVersion) {
     return { finalNodeType, finalTypeVersion };
 }
 async function loadKnownNodeBaseTypes() {
-    const workflowNodesDir = path_1.default.resolve(__dirname, '../workflow_nodes');
+    // When compiled, this file lives in dist/nodes/cache.js — go up two levels
+    // to reach the project root, matching the path in versioning.ts.
+    const workflowNodesDir = path_1.default.resolve(__dirname, '../../workflow_nodes');
     try {
         const entries = await promises_1.default.readdir(workflowNodesDir, { withFileTypes: true });
         const versionDirs = entries.filter(entry => entry.isDirectory()).map(entry => entry.name);
@@ -143,12 +145,28 @@ async function loadNodesFromDirectory(directory) {
                                 .filter((v) => !Number.isNaN(v))
                             : (typeof rawVersion === 'number' ? rawVersion : parseFloat(String(rawVersion)));
                         nodeInfoCache.set(officialType.toLowerCase(), { officialType, version: normalizedVersion });
+                        // Register short-name aliases so users can type just "chatTrigger"
+                        // instead of the full "@n8n/n8n-nodes-langchain.chatTrigger".
                         const prefix = "n8n-nodes-base.";
+                        const langchainPrefix = "@n8n/n8n-nodes-langchain.";
                         if (officialType.startsWith(prefix)) {
                             const baseName = officialType.substring(prefix.length);
                             if (baseName)
                                 nodeInfoCache.set(baseName.toLowerCase(), { officialType, version: normalizedVersion });
                         }
+                        else if (officialType.startsWith(langchainPrefix)) {
+                            const baseName = officialType.substring(langchainPrefix.length);
+                            if (baseName) {
+                                nodeInfoCache.set(baseName.toLowerCase(), { officialType, version: normalizedVersion });
+                                // LLMs often guess "httpRequestTool" instead of "toolHttpRequest".
+                                // Register reversed alias: toolFoo → fooTool.
+                                if (baseName.startsWith('tool') && baseName.length > 4) {
+                                    const inner = baseName.substring(4); // e.g. "HttpRequest"
+                                    const reversed = inner.charAt(0).toLowerCase() + inner.slice(1) + 'Tool'; // "httpRequestTool"
+                                    nodeInfoCache.set(reversed.toLowerCase(), { officialType, version: normalizedVersion });
+                                }
+                            }
+                        }
                     }
                 }
                 catch {

package/dist/nodes/versioning.js

@@ -4,6 +4,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getCurrentN8nVersion = getCurrentN8nVersion;
+exports.getN8nMajorVersion = getN8nMajorVersion;
+exports.isN8n2xOrLater = isN8n2xOrLater;
+exports.workflowActivationDefaults = workflowActivationDefaults;
 exports.getN8nVersionInfo = getN8nVersionInfo;
 exports.getSupportedN8nVersions = getSupportedN8nVersions;
 exports.initializeN8nVersionSupport = initializeN8nVersionSupport;
@@ -20,6 +23,25 @@ const N8N_API_URL = process.env.N8N_API_URL;
 function getCurrentN8nVersion() {
     return currentN8nVersion;
 }
+function getN8nMajorVersion() {
+    const v = currentN8nVersion;
+    if (!v)
+        return null;
+    const major = parseInt(v.replace(/^v/i, '').split('.')[0], 10);
+    return Number.isFinite(major) ? major : null;
+}
+function isN8n2xOrLater() {
+    const major = getN8nMajorVersion();
+    return major !== null && major >= 2;
+}
+// n8n 1.x needs `active: false` on new workflow JSON. n8n 2.x replaced this
+// with server-side Draft/Published state and rejects the field. Spread this
+// helper into new workflow objects so the shape adapts to the detected
+// instance. Callers on older versions or with no detection still get 1.x
+// behavior, which is the safe default.
+function workflowActivationDefaults() {
+    return isN8n2xOrLater() ? {} : { active: false };
+}
 function getN8nVersionInfo() {
     return n8nVersionInfo;
 }

package/dist/utils/constants.js

@@ -17,7 +17,7 @@ exports.MCP_SERVER_VERSION = packageVersion;
 exports.MCP_PROTOCOL_VERSION = '1.0';
 exports.HEADER_MCP_VERSION = 'X-MCP-Version';
 // Keep a single fallback for n8n versioning logic if ever needed by callers
-exports.DEFAULT_N8N_VERSION_FALLBACK = '1.104.1';
+exports.DEFAULT_N8N_VERSION_FALLBACK = '1.123.2';
 // Optional: canonical tool names to avoid typos
 exports.ToolNames = {
     create_workflow: 'create_workflow',

package/dist/utils/nodesDb.js

@@ -8,24 +8,33 @@ exports.listDbVersions = listDbVersions;
 exports.materializeBestVersion = materializeBestVersion;
 exports.materializeIfConfigured = materializeIfConfigured;
 const promises_1 = __importDefault(require("fs/promises"));
+const fs_1 = __importDefault(require("fs"));
 const path_1 = __importDefault(require("path"));
 const os_1 = __importDefault(require("os"));
+const zlib_1 = __importDefault(require("zlib"));
 const better_sqlite3_1 = __importDefault(require("better-sqlite3"));
 const versioning_1 = require("../nodes/versioning");
 /**
  * Environment helpers for nodes DB and cache settings.
  */
+function getBundledDbPath() {
+    // Bundled catalog shipped inside the package next to compiled output (dist/catalog.sqlite).
+    const candidate = path_1.default.resolve(__dirname, '..', 'catalog.sqlite');
+    return fs_1.default.existsSync(candidate) ? candidate : null;
+}
 function getNodesDbPath() {
     const envPath = process.env.N8N_NODES_DB_PATH?.trim();
     if (envPath && envPath.length > 0) {
         return path_1.default.resolve(envPath);
     }
-    // Default under user cache dir
     const home = os_1.default.homedir();
-    if (!home)
-        return null;
-    const defaultDir = path_1.default.join(home, '.cache', 'n8n-nodes');
-    return path_1.default.join(defaultDir, 'catalog.sqlite');
+    if (home) {
+        const userDb = path_1.default.join(home, '.cache', 'n8n-nodes', 'catalog.sqlite');
+        if (fs_1.default.existsSync(userDb))
+            return userDb;
+    }
+    // Fall back to catalog bundled inside the npm package.
+    return getBundledDbPath();
 }
 function getWorkflowNodesRootDir() {
     // Existing code expects workflow_nodes relative to compiled dist path
@@ -48,10 +57,37 @@ function readVersionMeta(db, version) {
         return null;
     }
 }
+function tableHasColumn(db, table, column) {
+    try {
+        const info = db.prepare(`PRAGMA table_info('${table}')`).all();
+        return info.some(r => r.name === column);
+    }
+    catch {
+        return false;
+    }
+}
 function* iterateNodes(db, version) {
-    const stmt = db.prepare('SELECT id, version, nodeType, baseName, typeVersion, filename, raw FROM nodes WHERE version = ?');
-    for (const row of stmt.iterate(version)) {
-        yield row;
+    // New schema (dedup+gzip): nodes joins blobs via sha256; blob stores gzipped JSON.
+    // Legacy schema: nodes has a raw TEXT column. Support both for forward compatibility.
+    const legacy = tableHasColumn(db, 'nodes', 'raw');
+    const sql = legacy
+        ? 'SELECT id, version, nodeType, baseName, typeVersion, filename, raw FROM nodes WHERE version = ?'
+        : 'SELECT n.id, n.version, n.nodeType, n.baseName, n.typeVersion, n.filename, b.gz FROM nodes n JOIN blobs b ON b.sha256 = n.sha256 WHERE n.version = ?';
+    const stmt = db.prepare(sql);
+    for (const raw of stmt.iterate(version)) {
+        const row = raw;
+        const rawText = legacy
+            ? (row.raw ?? '')
+            : zlib_1.default.gunzipSync(row.gz).toString('utf8');
+        yield {
+            id: row.id,
+            version: row.version,
+            nodeType: row.nodeType,
+            baseName: row.baseName,
+            typeVersion: row.typeVersion,
+            filename: row.filename,
+            raw: rawText,
+        };
     }
 }
 async function directoryExists(dir) {

package/dist/utils/workspace.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.PathSecurityError = exports.WORKFLOWS_FILE_NAME = exports.WORKFLOW_DATA_DIR_NAME = void 0;
 exports.getWorkspaceDir = getWorkspaceDir;
 exports.setWorkspaceDir = setWorkspaceDir;
+exports.sanitizeFilename = sanitizeFilename;
 exports.resolvePath = resolvePath;
 exports.resolveWorkflowPath = resolveWorkflowPath;
 exports.ensureWorkflowParentDir = ensureWorkflowParentDir;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "n8n-workflow-builder-mcp",
-    "version": "1.0.2",
+    "version": "2.0.0",
     "description": "MCP server for building n8n workflows",
     "main": "dist/index.js",
     "bin": {
@@ -8,6 +8,7 @@
     },
     "files": [
         "dist/",
+        "dist/catalog.sqlite",
         "README.md",
         "LICENSE"
     ],
@@ -24,9 +25,9 @@
         "test:langchain": "mocha tests/unit/langchain-llm-format.test.js",
         "mcp": "node n8n-workflow-mcp.js",
         "build": "tsc",
-        "postbuild": "chmod +x dist/index.js",
-        "build:nodes-db": "node scripts/build-nodes-db.js --source ./node_definitions",
-        "rebuild:nodes-db": "node scripts/build-nodes-db.js --source ./node_definitions --full-rebuild"
+        "postbuild": "chmod +x dist/index.js && node scripts/bundle-nodes-db.js",
+        "build:nodes-db": "node scripts/build-nodes-db.js --source ./workflow_nodes",
+        "rebuild:nodes-db": "node scripts/build-nodes-db.js --source ./workflow_nodes --full-rebuild"
     },
     "keywords": [
         "n8n",