n8n-decanter: Code Node'larını TypeScript Dosyasına Çeviren MCP Katmanı

n8n'in yerleşik MCP sunucusu kodlama ajanlarının workflow'ları yapısal olarak düzenlemesine izin veriyor, ama Code node'larının kaynağı workflow JSON'ı içinde çıplak bir string olarak saklandığı için bu düzenlemeler diff'lenemiyor, tip kontrolünden geçmiyor ve modül olarak paylaşılamıyor.

n8n-decanter, ajan ile n8n arasına giren bir MCP proxy'si: node ekleme, bağlama ve yayınlama gibi tüm yapısal yazmaları olduğu gibi iletirken sadece Code node'un jsCode alanına doğrudan yazmayı engelliyor. Bunun yerine her Code node'un kaynağı git deposunda kendi dosyasına çıkarılıyor, workflow.json ise salt-okunur bir yapı aynası olarak kalıyor.

Push sırasında dosyalar esbuild ile derleniyor; paylaşılan modüller ve tercih edilen npm bağımlılıkları n8n'in gerektirdiği tek fonksiyon gövdesine gömülüyor. Tip kontrolü, node'un gerçek çalışma zamanı bağlamını ($input, üst düzey return/await) taklit eden özel bir TypeScript derleyici host'u üzerinden yapılıyor. Push'lar draft'a düşüyor, yayınlama ayrı ve korumalı bir adım; uyumluluk ve drift kontrolleri bağımsız çalışıyor — --force bayrağı sadece eşzamanlılık uyarısını atlayabiliyor, yapısal hataları asla.

Sonuç: mühendisler ajanın yapısal düzenleme hızını kaybetmeden iş mantığını git, TypeScript ve code review'un altına alabiliyor. Araç, npm üzerinde MIT lisanslı bir CLI olarak dağıtılıyor.