/ الدليل / الملعب / n8n-workflow-builder
← كل الخوادم ↗ GitHub
● مجتمع makafeli ⚡ فوري

n8n-workflow-builder

بواسطة makafeli · makafeli/n8n-workflow-builder

بناء وتشغيل سير عمل n8n من اللغة الطبيعية — 15 أداة للإنشاء والتفعيل والتنفيذ بالإضافة إلى تقارير التدقيق، متصلة بـ n8n المستضاف ذاتياً أو السحابي.

n8n-workflow-builder (makafeli) هو MCP يتواصل مع أي مثيل n8n عبر REST API. تغطي 15 أداة دورة حياة سير العمل كاملة: القائمة، والإنشاء مع العقد، والتفعيل، والتنفيذ، والتحديث، والحذف، بالإضافة إلى سجل التنفيذ والتدقيقات الأمنية.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

n8n-workflow-builder.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "n8n-workflow-builder": {
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ],
      "_inferred": true
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "n8n-workflow-builder",
      "command": "npx",
      "args": [
        "-y",
        "n8n-workflow-builder"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "n8n-workflow-builder": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "n8n-workflow-builder"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add n8n-workflow-builder -- npx -y n8n-workflow-builder

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: n8n-workflow-builder

بناء سير عمل n8n من وصف باللغة الطبيعية

👤 مديرو المنتجات بلا كود، المؤسسون المنفردون، العمليات الداخلية ⏱ ~20 min intermediate

متى تستخدمه: تريد سير عمل webhook → Slack → Google Sheet دون سحب العقد.

المتطلبات الأساسية
  • مثيل n8n قيد التشغيل مع تمكين API — docker run n8nio/n8n; enable N8N_API in env
  • مفتاح API — n8n Settings → API Keys
الخطوات
  1. وصف سير العمل
    إنشاء سير عمل n8n: عند تفعيل webhook /signup، أرسل الحمولة إلى Slack #signups وأضف صفًا إلى الورقة 'Signups'.✓ تم النسخ
    → تم إنشاء سير عمل بـ 3 عقد متصلة
  2. تفعيل
    تفعيل سير العمل وإرجاع عنوان webhook الإنتاجي.✓ تم النسخ
    → نشط + URL
  3. اختبار الدخان
    نفذه مرة واحدة بحمولة نموذجية، ثم اسحب سجل التنفيذ.✓ تم النسخ
    → تشغيل ناجح أو فشل قابل للتحديد

النتيجة: تشغيل أتمتة في بضع موجهات بدلاً من قضاء الصباح في المحرر.

المزالق
  • بيانات الاعتماد لم تُعين على العقد التي تم إنشاؤها حديثًا — MCP لا يمكنه إنشاء أسرار لك — أضف بيانات Slack/Google في واجهة n8n مرة واحدة، وأشر إليها بالاسم
اجمعها مع: google-sheets

تصحيح سير عمل n8n الفاشل من سجل التنفيذ

👤 مهندسو العمليات الذين يحافظون على الأتمتة ⏱ ~25 min intermediate

متى تستخدمه: سير عمل ليلي يفشل وتريد تقييم الأولويات من الدردشة.

الخطوات
  1. سحب الأعطال الأخيرة
    list_executions لسير العمل 'nightly-export' مع status=error في آخر 7 أيام.✓ تم النسخ
    → قائمة بالتواريخ والمقاطع الخطأ
  2. فحص الأسوأ
    get_execution على أحدث فشل. اعرض لي إدخال العقدة الفاشلة والخطأ.✓ تم النسخ
    → تلميح السبب الجذري
  3. تصحيح وإعادة نشر
    تحديث سير العمل للتعامل مع قيم null في عقدة التحويل. ثم قم بإلغاء التفعيل + التفعيل لإعادة التحميل.✓ تم النسخ
    → نجح التشغيل اللاحق

النتيجة: تم حل الانقطاع دون فتح المحرر.

تشغيل تدقيق أمني على سير عمل n8n الخاص بك

👤 فرق الأمان والعمليات ⏱ ~15 min intermediate

متى تستخدمه: قبل الانتقال إلى الإنتاج، أو كل ربع سنة، تريد تقريرًا على غرار الامتثال.

الخطوات
  1. إنشاء التدقيق
    استخدم generate_audit على مثيل n8n الخاص بي. لخص النتائج إلى: بيانات الاعتماد، وتعريض webhook، وقضايا أذونات العقدة.✓ تم النسخ
    → تقرير تدقيق منظم
  2. توثيق العناصر المحفوفة بالمخاطر
    لكل نتيجة عالية الخطورة، أنشئ مسألة في Linear/GitHub مع تصحيح.✓ تم النسخ
    → تم إنشاء المسائل

النتيجة: أتمتة نظافة الأمان ربع السنوية.

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

n8n-workflow-builder + google-sheets

أتمتة webhook-to-sheet تم بناؤها ومراقبتها من الدردشة

إنشاء سير عمل n8n يلحق الحمولات بورقة 'Leads' الخاصة بي؛ تحقق من أنه يعمل من البداية إلى النهاية.✓ تم النسخ
n8n-workflow-builder + sentry

تنبيه Sentry → سير عمل n8n → سلسلة الاستجابة للحوادث

عندما يرى Sentry ارتفاعًا على المشروع X، شغل سير عمل n8n الخاص بي 'incident-page' عبر execute_workflow.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_workflows نظرة عامة 1 API call
get_workflow id فحص العقد 1 API call
create_workflow name, nodes[], connections أتمتة جديدة 1 API call
execute_workflow id, payload? تفعيل يدوي / اختبار n8n CPU + downstream
activate_workflow id شحن إلى الإنتاج 1 API call
deactivate_workflow id الصيانة / الرجوع 1 API call
update_workflow id, changes تصحيح العقد 1 API call
delete_workflow id الإحالة للتقاعد 1 API call
list_executions workflow_id?, status? تقييم الأولويات 1 API call
get_execution execution_id السبب الجذري 1 API call
generate_audit المراجعة الأمنية 1 API call

التكلفة والحدود

تكلفة التشغيل

حصة API
n8n نفسه لا يوجد حد معدل API بعيد عن سعة الخادم الخاص بك
الرموز لكل استدعاء
JSON سير العمل يمكن أن يكون كبيرًا — 2-10 آلاف رمز لكل get_workflow على سير العمل المعقدة
التكلفة المالية
مجاني إذا كان مستضاف ذاتياً؛ يتم فرض رسوم n8n Cloud لكل تنفيذ
نصيحة
استخدم list_workflows أولاً، تجنب get_workflow على سير العمل الضخمة ما لم تحتاج تفاصيل العقدة

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: N8N_API_KEY في env — يمنح وصول API كامل، حدد النطاق وفقًا لذلك
نقل البيانات الخارجي: فقط إلى N8N_HOST الخاص بك

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

401 Unauthorized

مفتاح API خاطئ أو المفتاح يفتقر إلى الأذونات — أعد الإنشاء في واجهة n8n

تحقق: curl -H 'X-N8N-API-KEY: <key>' $N8N_HOST/api/v1/workflows
تم إنشاء سير العمل لكنه يفشل عند التنفيذ

العقد لا تحتوي على بيانات اعتماد — اربطها في الواجهة بعد الإنشاء؛ MCP لا يمكنه تعيين الأسرار

execute_workflow معلق

سير عمل طويل الأمد — استخدم activate + webhook trigger بدلاً من sync execute

البدائل

n8n-workflow-builder مقابل البدائل

البديلمتى تستخدمهاالمقايضة
n8n REST API المباشرأنت تكتب البرامج النصية، وليس الدردشةأنت تكتب الأنابيب
Zapier MCPأنت في Zapier وليس n8nنظام بيئي مختلف؛ مدفوع

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills