/ الدليل / الملعب / n8n-mcp
← كل الخوادم ↗ GitHub
● مجتمع czlonkowski 🔑 يتطلب مفتاحك

n8n-mcp

بواسطة czlonkowski · czlonkowski/n8n-mcp

دع وكيلك يصمم ويتحقق من صحة وينشر سير العمل في n8n — مع فهرس عقدة مدمج والتحقق من الصحة حتى يكون JSON صحيحاً من المحاولة الأولى.

يوفر czlonkowski/n8n-mcp لوكيلك معرفة عميقة بفهرس عقد n8n بالإضافة إلى إدارة حية لمثيل n8n الخاص بك. ابحث عن 500+ عقدة، تحقق من صحة JSON سير العمل قبل النشر، وأنشئ من القوالب، وادفع مباشرة إلى n8n عبر API الخاص به. مثالي لبناء الأتمتة بشكل حواري.

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

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

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

عرض مباشر

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

n8n-mcp.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add n8n-mcp -- npx -y n8n-mcp

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

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

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

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

👤 مهندسو Ops والقراصنة المستقلون الذين يستخدمون n8n ⏱ ~20 min intermediate

متى تستخدمه: أنت تعرف ما تريده ('كل استمارة Typeform جديدة تذهب إلى Notion + Slack') لكنك لا تريد النقر عبر واجهة مستخدم n8n لمدة 20 دقيقة.

المتطلبات الأساسية
  • مثيل n8n (سحابة أو محلية) — أي n8n يعمل؛ مطلوب فقط لخطوة النشر، وليس للتصميم
  • N8N_API_URL + N8N_API_KEY — إعدادات n8n → n8n API → إنشاء مفتاح API
الخطوات
  1. ابحث عن العقد لكل خطوة
    أريد: webhook Typeform → تحليل → إنشاء صفحة Notion → منشور إلى Slack. ابحث عن أنواع العقد الدقيقة التي أحتاجها.✓ تم النسخ
    → تم تحديد أسماء العقد + بيانات الاعتماد المطلوبة
  2. إنشاء JSON سير العمل
    إنشاء سير عمل كامل مع تلك 4 عقد متصلة بالترتيب. استخدم قالباً كأساس إن وجد.✓ تم النسخ
    → JSON سير عمل n8n صحيح
  3. التحقق من الصحة والنشر
    تحقق من صحة JSON باستخدام validate_workflow. أصلح أي أخطاء. ثم انشر إلى n8n الخاص بي كمسودة (غير نشطة).✓ تم النسخ
    → يظهر سير العمل في واجهة مستخدم n8n في حالة المسودة

النتيجة: سير عمل n8n يعمل، أسرع 10 مرات من النقر اليدوي، مع التحقق من الصحة يلتقط الأخطاء قبل النقر على تشغيل.

المزالق
  • يجب إعداد بيانات الاعتماد في n8n أولاً — JSON يشير إليها بـ ID — أنشئ إدخالات بيانات الاعتماد في واجهة مستخدم n8n قبل النشر؛ مرر معرفات بيانات الاعتماد إلى الوكيل
  • الوكيل ينشر نشط ويطلق فوراً على البيانات التاريخية — دائماً انشر غير نشط؛ انشط يدويا بعد الاختبار في واجهة مستخدم n8n

تدقيق مثيل n8n الخاص بك بحثاً عن سير عمل مكسور أو خطير

👤 قادة Ops الذين يرثون مثيل n8n ⏱ ~30 min intermediate

متى تستخدمه: استحوذت على مثيل n8n يحتوي على 50 سير عمل، بدون وثائق. تحتاج إلى معرفة ما يوجد هناك وما هو محفوف بالمخاطر.

الخطوات
  1. سرد جميع سير العمل
    اسرد كل سير عمل باسم وحالة نشط ووقت آخر تنفيذ وعدد العقد.✓ تم النسخ
    → قائمة جرد كاملة
  2. علم الأنماط المحفوفة بالمخاطر
    ابحث عن سير عمل بـ: لا معالجة الأخطاء، محفزات webhook بدون مصادقة، عقد HTTP Request إلى عناوين URL عشوائية، أو عقد أوامر shell.✓ تم النسخ
    → قائمة المخاطر مع الأساس المنطقي
  3. تحقق من معدلات الفشل
    لكل سير عمل نشط، احصل على آخر 20 تنفيذ. حساب معدل الفشل. علم أي شيء >20%.✓ تم النسخ
    → قائمة سير العمل المكسور

النتيجة: قائمة جرد المخاطر والصحة — اعرف ما يجب إصلاحه أو تجميده أو حذفه.

المزالق
  • تعطيل سير عمل يعتمد عليه سير عمل آخر (عبر عقدة Execute Workflow) — قبل التعطيل، ابحث عن سير عمل آخر للإشارات إلى الهدف بواسطة ID

ابدأ من قالب وخصصه

👤 مستخدمو n8n الجدد ⏱ ~15 min beginner

متى تستخدمه: من المرجح أن يكون شخص ما قد بنى شيئاً قريباً من ما تحتاجه — استخدم ذلك كنقطة انطلاق.

الخطوات
  1. ابحث عن القوالب
    ابحث عن القوالب التي تفعل: 'مزامنة ملف CSV مع قاعدة بيانات مع إزالة التكرار'.✓ تم النسخ
    → 3-5 قوالب مرشحة مرتبة حسب الصلة
  2. احصل وتكيف
    احصل على JSON للمطابقة الأولى. قم بتكييف العقد لاستخدام قاعدة البيانات الفعلية الخاصة بي (Postgres على host X) ومصدر CSV الخاص بي (S3 bucket Y).✓ تم النسخ
    → JSON سير العمل المخصص
  3. التحقق من الصحة والنشر
    تحقق من الصحة، ثم انشر كمسودة إلى n8n الخاص بي.✓ تم النسخ
    → سير العمل المسودة في n8n

النتيجة: سير عمل يعمل في 10 دقائق بالوقوف على أكتاف شخص آخر.

المزالق
  • القوالب تستخدم إصدارات عقدة مهملة — تحقق من إخراج validate_workflow لتحذيرات الإصدار؛ قم بتبديل العقد الحالية

التركيبات

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

n8n-mcp + notion

قالب سير عمل n8n يكتب إلى قاعدة بيانات Notion معينة — ابحث عن مخطط قاعدة البيانات أولاً

ابحث عن مخطط قاعدة بيانات 'Leads' في Notion الخاصة بي. ثم بناء سير عمل n8n يأخذ إدخال webhook وينشئ إدخالات متطابقة.✓ تم النسخ
n8n-mcp + linear

إنشاء تذاكر Linear تلقائياً لأخطاء سير عمل n8n

تدقيق n8n الخاصة بي بحثاً عن سير العمل الذي يفشل في >20% من المدة. لكل واحد، أنشئ خطأ Linear.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
tools_documentation tool_name? اكتشف الأدوات المتاحة free
search_nodes query, limit? ابحث عن عقد n8n التي تطابق احتياجاً free
get_node node_type, mode? الغوص العميق في عقدة معينة قبل توصيلها free
validate_node node JSON تحقق من تكوين عقدة واحدة free
validate_workflow workflow JSON دائماً — قبل أي نشر free
search_templates query/keywords/nodes ابحث عن الأعمال السابقة قبل البناء من الصفر free
get_template template_id احصل على قالب مختار free
create_workflow / update_workflow / delete_workflow requires N8N_API_URL/KEY انشر أو غيّر على المثيل الحقيقي 1 n8n API call
trigger_workflow / get_executions workflow_id, data? اختبر سير عمل منشور 1 n8n API call
audit_instance مراجعة المثيل الدورية multiple API calls

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

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

حصة API
أدوات البحث والتحقق: غير محدود (بيانات محلية). أدوات الإدارة: محدود بسعة مثيل n8n الخاص بك.
الرموز لكل استدعاء
يمكن أن تكون مخططات العقد كبيرة (2-5k token)؛ استخدم get_node مع mode='minimal' عندما تحتاج فقط إلى الأنواع
التكلفة المالية
MCP مجاني؛ n8n لديها طبقة سحابية ($20+/شهر) أو استضافة ذاتية مجانية
نصيحة
صمم بالكامل مع البحث والتحقق أولاً (مجاني). استدعِ create/update فقط بعد التأكد — كل نشر يكلف فتحة حصة على سحابة n8n

الأمان

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

تخزين بيانات الاعتماد: N8N_API_KEY في متغير البيئة — يعامل مثل رمز المسؤول حيث يمكنه إنشاء سير العمل
نقل البيانات الخارجي: يعمل n8n-mcp MCP نفسه محلياً. أدوات الإدارة تستدعي N8N_API_URL الخاص بك.

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

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

Management tools not appearing

N8N_API_URL أو N8N_API_KEY لم يتم تعيينهما. تسجل أدوات الإدارة فقط عندما يكون متغيرا البيئة موجودة عند البدء.

تحقق: echo $N8N_API_URL && echo $N8N_API_KEY | cut -c1-6
validate_workflow passes but n8n rejects at deploy

من المرجح أن تكون مشكلة إشارة بيانات الاعتماد. يتم التحقق من بيانات الاعتماد مقابل الأسماء في مثيل n8n الخاص بك — تحقق من تطابق أسماء بيانات الاعتماد بالضبط.

Workflow deploys but fails on first run with 'Node type not found'

أنت تستخدم عقدة من حزمة مجتمع غير مثبتة على مثيل n8n. ثبتها في n8n أولاً أو قم بالتبديل إلى عقدة أساسية.

Template JSON uses deprecated node versions

بعد الجلب، مرر من خلال validate_workflow — إنه يعلم الإصدارات المهملة. قم بترقية العقد قبل النشر.

البدائل

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

البديلمتى تستخدمهاالمقايضة
Zapier MCPفريقك على Zapier وليس n8nاستضافة فقط؛ تحكم أقل لكن تكاملات أكثر صقل
Make (Integromat) MCPفريقك على Makeاستضافة؛ نموذج السيناريو يختلف عن نموذج الرسم البياني في n8n
Raw n8n REST APIتريد تحكماً على مستوى الكود من سكريبت مخصصلا توجد قائمة عقدة أو تحقق من الصحة — أنت بمفردك للحصول على الصحة

المزيد

الموارد

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

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

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