n8n-mcp

نظرة عامة

n8n-mcp هو خادم مفتوح المصدر لبروتوكول سياق النموذج (MCP) يربط مساعدي الترميز بالذكاء الاصطناعي بمنصة أتمتة سير العمل n8n. يزود أدوات مثل Claude Desktop و Claude Code و Cursor و Windsurf و VS Code بمعرفة منظمة وفي الوقت الفعلي بكامل نظام n8n البيئي — بما في ذلك 537 عقدة أساسية + 547 عقدة مجتمعية (إجمالي 1,084)، و2,709 قوالب سير عمل، ومنطق تصديق خاص بالذكاء الاصطناعي.

مبني كتطبيق خفيف الوزن بـ Node.js مع قاعدة بيانات SQLite مدمجة، يقدم استجابات أقل من 12 مللي ثانية ويعمل في وضع stdio أو HTTP. قم بتوصيله مرة واحدة ودع الذكاء الاصطناعي الخاص بك يبني ويصدق ويختبر وينشر سير عمل n8n كاملة دون نسخ ولصق أو تهيئة يدوية.

يتوفر إصدار مستضاف مع وكيل دردشة جاهز للاستخدام على n8n-mcp.com (مستوى مجاني + خطط مدفوعة)، بينما يظل مستودع GitHub قابلاً للاستضافة الذاتية بالكامل تحت رخصة MIT.

الميزات الرئيسية

• قاعدة معرفة شاملة بالعقد — وصول كامل إلى 1,084 عقدة n8n مع تغطية 99% للخصائص، و63.6% للعمليات، و87% من الوثائق الرسمية (محدثة خلال 48 ساعة من إصدارات n8n الجديدة).
• بحث ذكي واكتشاف — search_nodes، get_node (عدة أوضاع تفصيلية)، وتصفية عقد المجتمع حسب المصدر (موثق/مجتمعي).
• أمثلة واقعية — 2,646 تهيئة مستخرجة مسبقًا من قوالب شائعة.
• تصديق متقدم — validate_node و validate_workflow مع ملفات تعريف وكلاء الذكاء الاصطناعي، وفحوصات وقت التشغيل، وتحليل التبعيات. يدعم سير عمل AI Agent في n8n v2.17+.
• محرك القوالب — البحث واسترجاع أكثر من 2,709 JSON لسير عمل جاهزة للاستخدام مع تصفية ذكية.
• أدوات إدارة n8n (اتصال API اختياري) — إنشاء وتحديث واختبار وتنفيذ وإصلاح تلقائي لسير العمل مباشرة في مثيل n8n الخاص بك.
• الأداء والتوافق — ~12 مللي ثانية متوسط وقت الاستجابة، استهلاك ذاكرة 70–120 ميغابايت، يعمل مع أي إصدار من Node.js. يدعم أوضاع stdio (Claude Desktop) و HTTP/SSE.
• الخصوصية والأمان — تتبع مجهول اختياري (سهل التعطيل)، لا بيانات اعتماد مشفرة بشكل ثابت، أوضاع أمان للويب هوك.

التثبيت والإعداد

البدء السريع (npx – بدون تثبيت)

npx n8n-mcp

أضفه إلى ملف claude_desktop_config.json في Claude Desktop مع MCP_MODE=stdio.

Docker (موصى به للإنتاج)

docker pull ghcr.io/czlonkowski/n8n-mcp:latest
docker run -i ghcr.io/czlonkowski/n8n-mcp:latest

السحابة (بنقرة واحدة)

انشر مجانًا على Railway باستخدام قالب المستودع.

بناء محلي كامل

git clone https://github.com/czlonkowski/n8n-mcp.git
cd n8n-mcp
npm install
npm run build
npm run rebuild
npm start

متغيرات البيئة الاختيارية: N8N_API_URL، N8N_API_KEY (لإدارة سير العمل المباشرة)، LOG_LEVEL=error، MCP_MODE=stdio.

مساعدو الذكاء الاصطناعي المدعومون

• Claude Desktop / Claude Code
• Cursor
• Windsurf
• VS Code + Codex
• Antigravity
• أي عميل متوافق مع MCP (أكثر من 20 أداة عبر الخدمة المستضافة)

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

• إنشاء سير عمل مدعوم بالذكاء الاصطناعي — صف “مراقبة الإشارات على تويتر ونشر الملخصات على Slack مع تحليل المشاعر” → يقوم الذكاء الاصطناعي بتوليد وتصديق ونشر الـ JSON الكامل.
• صيانة سير العمل الموجودة — يقرأ الذكاء الاصطناعي سير العمل الحية، يقترح تحسينات، ويطبق تحديثات مستهدفة.
• استكشاف القوالب — اطلب “أفضل قالب مزامنة CRM باستخدام عقد مجتمعية” واحصل على JSON جاهز للاستيراد.
• أتمتة المؤسسات — اتصل بمثيلات n8n المستضافة ذاتيًا لتوليد سير عمل آمنة ومدققة على نطاق واسع.
• التعلم والنمذجة الأولية — استخدم أدوات التصديق لتعليم الذكاء الاصطناعي أفضل الممارسات قبل النشر في الإنتاج.

MCP المدمج في n8n مقابل n8n-mcp

خادم MCP الأصلي في n8n (متوفر في الإصدارات الحديثة) يكشف سير عملك الخاصة كأدوات. n8n-mcp هو خادم MCP خارجي مكمل يركز على معرفة عقد n8n وتأليف مساعد بالذكاء الاصطناعي. استخدمهما معًا للحصول على أقصى قوة: الخادم الأصلي لتشغيل سير العمل + n8n-mcp لبناء سير عمل ذكي.

الروابط والموارد

• GitHub: czlonkowski/n8n-mcp
• وكيل الدردشة المستضاف واللوحة: n8n-mcp.com
• المستوى المجاني: 100 استدعاء أداة/يوم (مستضاف) أو غير محدود عند الاستضافة الذاتية
• الوثائق والأمثلة في المستودع

n8n-mcp يحول أي مساعد ترميز بالذكاء الاصطناعي إلى خبير كامل في سير عمل n8n — فورًا.