Skip to content

v2.4.2: Instant Script-Based Deployments

Choose a tag to compare

View all tags
@KenKaiii KenKaiii released this 23 Aug 20:12
· 9 commits to main since this release
v2.4.2
2b86e32

Ken8n-Coder v2.4 Release Notes

🚀 Performance Breakthrough: Instant Workflow Deployments

The Problem

BUILD agents were experiencing massive performance bottlenecks when deploying workflows to n8n. Agents had to manually type out entire workflow JSON objects (often 10,000+ characters), which could take 5-10 minutes per deployment. This made iterative development painfully slow.

The Solution

Complete architectural transformation to script-based deployment:

  • MCP server now accepts file paths instead of JSON objects
  • Deploys workflows instantly by reading files directly
  • BUILD agents simply provide the file path: n8n_deploy({ workflowFile: "workflow.json" })
  • Deployments that took minutes now complete in under 1 second

📦 What's New in v2.4

v2.4.0 - Script-Based Architecture

  • Changed: n8n_deploy now accepts workflowFile parameter instead of workflow
  • Added: Deploy script with dual-mode operation (agent instructions vs JSON output)
  • Updated: BUILD agent instructions to use file-based deployment exclusively
  • Result: 99% reduction in deployment time

v2.4.1 - Package Structure Fix

  • Fixed: Include deploy-script in NPM package distribution
  • Added: Support for multiple script path locations

v2.4.2 - Path Resolution Fix

  • Fixed: Correct path resolution for NPX installations
  • Added: Fallback path logic (user → package → local)
  • Fixed: TypeScript linting issues

💪 Impact on BUILD Agents

Before: Agents manually recreated entire JSON structures

// ❌ OLD WAY - Took 5-10 minutes
n8n_deploy({ 
  workflow: {
    name: "My Workflow",
    nodes: [...hundreds of lines...],
    connections: {...more lines...}
  }
})

After: Agents use file paths for instant deployment

// ✅ NEW WAY - Takes <1 second
n8n_deploy({ workflowFile: "my-workflow.json", active: true })

🔧 Technical Details

MCP Server Changes

  • Executes deploy-script internally with --json-output flag
  • Parses JSON output and sends to n8n API
  • No manual JSON typing required

Deploy Script

  • Dual-mode operation based on --json-output flag
  • Agent mode: Shows copy-paste instructions (legacy)
  • MCP mode: Outputs raw JSON for internal consumption

BUILD Agent Instructions

  • Completely rewritten to use file-based deployment
  • Removed all copy-paste method references
  • Simplified deployment to single function call

📈 Performance Metrics

Metric Before After Improvement
Deployment Time 5-10 minutes <1 second 99.8% faster
Agent Typing 10,000+ chars 50 chars 99.5% reduction
Error Rate High (typos) Zero 100% improvement
Iteration Speed Very slow Instant 10-20x faster

🎯 Benefits

  1. Developer Experience: Instant feedback loop for workflow development
  2. Reliability: No more JSON syntax errors from manual typing
  3. Scalability: Can handle workflows of any size without performance degradation
  4. Simplicity: Single command deployment instead of complex copy-paste process

📦 Installation

Update to the latest version:

npm install -g @kenkaiii/ken8n-mcp@latest

Or for Claude Code users:

claude mcp remove n8n
claude mcp add n8n npx @kenkaiii/ken8n-mcp@latest --env N8N_API_KEY="your-key" --env N8N_BASE_URL="your-url"

🙏 Acknowledgments

This performance improvement was driven by user feedback about slow BUILD agent deployments. The new architecture represents a complete rethinking of how workflows are deployed, prioritizing speed and reliability.

Full Changelog: v2.3.10...v2.4.2

Assets 9
Loading