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

mcp-n8n-workflow-builder

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

بناء وإدارة ومراقبة مسارات عمل n8n باستخدام اللغة الطبيعية — بدون تعديل JSON، يعمل مع إعدادات متعددة البيئات (الإنتاج/الإعداد/التطوير).

mcp-n8n-workflow-builder من salacoste يعرّض n8n REST API من خلال 17 أداة MCP تغطي المسارات والعمليات والعلامات وإدارة بيانات الاعتماد. يسمح الإعداد متعدد البيئات لوكيل واحد بالتبديل بين الإنتاج والإعداد والتطوير. مثالي للعمل التكراري على الأتمتة بطريقة حوارية.

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

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

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

عرض مباشر

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

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

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

إنشاء مسار عمل n8n من وصف نصي

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

متى تستخدمه: تريد إنشاء 'عند إضافة صف إلى Airtable، أرسل رسالة Slack' بدون النقر على 15 عقدة.

المتطلبات الأساسية
  • مثيل n8n يعمل مع API مفعل — التثبيت القياسي لـ n8n؛ احصل على مفتاح API من الإعدادات > API
  • متغيرات البيئة N8N_HOST + N8N_API_KEY (احذف لاحقة /api/v1) — اضبطها في إعدادات MCP
الخطوات
  1. وصف النية
    أنشئ مسار عمل 'airtable-to-slack': تفعيل عند إضافة صف جديد في جدول Airtable base X table Y، انشر رسالة إلى قناة Slack #updates تتضمن اسم الصف وحالته.✓ تم النسخ
    → تم إنشاء المسار، تم إرجاع عنوان URL
  2. التحقق من العقد
    احصل على المسار بواسطة id وأخبرني بتسلسل العقد.✓ تم النسخ
    → سلسلة العقد تطابق النية
  3. تفعيل
    فعّل المسار.✓ تم النسخ
    → الحالة: نشط

النتيجة: مسار عمل يعمل في دقائق بدلاً من القفز بين علامات التبويب في واجهة n8n.

المزالق
  • تم إنشاء بيانات الاعتماد في البيئة الخاطئة — اضمن دائماً تضمين اسم البيئة في الرموز ('في بيئة الإعداد...') عند استخدام إعدادات متعددة البيئات
  • قد تفتقد المعاملات المولدة تلقائياً بعض الحقول الخاصة — قم بمراجعة يدوية واحدة للعقدة بعد الإنشاء؛ n8n صارم فيما يتعلق بمعاملات التشغيل
اجمعها مع: airtable · github

تصحيح أخطاء تنفيذ n8n الفاشل

👤 أي شخص يقوم بتشغيل n8n في الإنتاج ⏱ ~15 min intermediate

متى تستخدمه: فشل المسار في الساعة الثالثة صباحاً وتريد معرفة ما حدث.

الخطوات
  1. البحث عن الأعطال الأخيرة
    list_executions status=error من آخر 24 ساعة على الإنتاج.✓ تم النسخ
    → قائمة الأعطال
  2. فحص واحد
    احصل على get_execution للأحدث — أي عقدة فشلت، مع أي خطأ؟✓ تم النسخ
    → العقدة + تتبع المكدس
  3. إعادة المحاولة أو الإصلاح
    إذا كان عابراً، قم بـ retry_execution. إذا كان الخطأ في الكود، اقترح تغيير عقدة في مسار JSON.✓ تم النسخ
    → تم اتخاذ إجراء

النتيجة: السبب الجذري + إما الاسترجاع أو اقتراح تصحيح.

اجمعها مع: sentry

تصنيف مجموعات المسارات والتدقيق في بيانات الاعتماد

👤 مسؤولو المنصة ⏱ ~30 min intermediate

متى تستخدمه: ورثت مثيل n8n وتحتاج إلى تنظيمه.

الخطوات
  1. قائمة وتصنيف المسارات
    احصل على list_workflows — صنف كل واحد كـ {تسويق، داخلي، عمليات، غير مستخدم}.✓ تم النسخ
    → التصنيف
  2. تطبيق العلامات
    ضع علامات على كل واحد حسب التصنيف باستخدام create_tag وتحديث المسار.✓ تم النسخ
    → تم تطبيق العلامات
  3. التدقيق في بيانات الاعتماد
    احصل على list_credentials — حدد أي منها مشترك عبر البيئات أو غير مستخدم منذ أكثر من 90 يوماً.✓ تم النسخ
    → قائمة التنظيف

النتيجة: إعداد n8n أنظف وقابل للمراجعة والتدقيق.

التركيبات

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

n8n-workflow-builder-2 + airtable

تصميم ونشر تدفق من Airtable إلى Slack

صمّم مسار عمل n8n ينشر رسالة إلى Slack عند إضافة صفقة جديدة إلى CRM الـ Airtable؛ أضف معالجة للأخطاء.✓ تم النسخ
n8n-workflow-builder-2 + sentry

تتبع أخطاء n8n في Sentry

عند حدوث خطأ في تنفيذ المسار، أرسل إلى Sentry مع اسم المسار وبيانات العقدة.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_workflows filter?: object نظرة عامة استدعاء API واحد
get_workflow id: str فحص رسم بياني العقد استدعاء API واحد
create_workflow name, nodes, connections, active? بناء مسار جديد استدعاء API واحد (كتابة)
update_workflow id, nodes?, connections?, name? تعديل الموجود استدعاء API واحد (كتابة)
delete_workflow id مع التأكيد استدعاء API واحد (تدميري)
activate_workflow id الإطلاق المباشر استدعاء API واحد
deactivate_workflow id الإيقاف المؤقت بدون حذف استدعاء API واحد
execute_workflow id, data? تفعيل عند الطلب استدعاء API واحد
list_executions filter? المراقبة استدعاء API واحد
get_execution id الفحص بعد الحادث استدعاء API واحد
retry_execution id استرجاع من الفشل العابر استدعاء API واحد
create_credential name, type, data توفير التوثيق للعقد استدعاء API واحد (كتابة)

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

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

حصة API
حدود مثيل n8n (المستضاف ذاتياً غير محدود)
الرموز لكل استدعاء
مسار JSON يمكن أن يصل إلى 5-20 ألف توكن للمسارات المعقدة
التكلفة المالية
مجاني (مجتمع n8n) أو مدفوع (n8n Cloud)
نصيحة
اطلب ملخصاً (عقد + محفزات) بدلاً من مستودعات JSON الكاملة إلا عند التعديل.

الأمان

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

تخزين بيانات الاعتماد: N8N_API_KEY في متغيرات البيئة؛ مفاتيح البيئات المتعددة في .config.json (مستبعدة من git)
نقل البيانات الخارجي: الكل يذهب إلى مثيل n8n الخاص بك
لا تمنح أبدًا: تضمين N8N_HOST مع لاحقة /api/v1 — احذف اللاحقة أو ستفشل استدعاءات الأداة مشاركة مفتاح API عبر الإنتاج والتطوير بدون وضع علامات

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

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

401 من n8n

مفتاح API غير صالح أو منتهي الصلاحية؛ أعد إنشاء في الإعدادات > API.

تحقق: curl -H 'X-N8N-API-KEY: $KEY' $N8N_HOST/api/v1/workflows
404 على create_workflow

N8N_HOST يحتوي على /api/v1 مرفقة؛ احذفها.

تحقق: تحقق من الإعدادات
فشل المسار المُنشأ في التفعيل

بيانات اعتماد العقدة مفقودة. أنشئ بيانات الاعتماد أولاً، ثم ارجع إليها بمعرّفها في المسار.

تحقق: احصل على المسار وابحث عن مراجع بيانات اعتماد فارغة

البدائل

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

البديلمتى تستخدمهاالمقايضة
Zapier MCPكنت على Zapier بدلاً من n8nنظام بيئي مختلف؛ n8n قابل للاستضافة الذاتية، Zapier ليس كذلك
Native n8n AI nodesتريد AI داخل المسار بدلاً من خارجهلا توجد سيطرة دردشة خارجية

المزيد

الموارد

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

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

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