Coolify MCP Server

نظرة عامة

خادم Coolify MCP هو خادم بروتوكول سياق النموذج (MCP) الرائد من بناء المجتمع لـ Coolify، منصة PaaS مفتوحة المصدر مستضافة ذاتيًا كبديل شهير لـ Heroku و Vercel و Netlify. يتيح هذا الخادم لمساعدات البرمجة الذكية (Claude Desktop، Cursor، Claude Code، إلخ.) إدارة مثيل Coolify الخاص بك بالكامل وتصحيح أخطائه باستخدام أوامر اللغة الطبيعية.

مع 38 أداة مُحسَّنة بشدة، وطريقة ذكية للبحث عن الموارد (بالاسم/النطاق/IP بدلاً من UUIDs)، وردود فعالة في استخدام الرموز المميزة (Tokens)، وميزة بحث نصي كامل مُدمَجة في الوثائق، يحول هذا الخادم مساعدك الذكي إلى مُساعد قوي في مجال DevOps للعمليات النشر المستضافة ذاتيًا.

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

1. 38 أداة مُحسَّنة: تغطي البنية التحتية، الخوادم، المشاريع، التطبيقات، قواعد البيانات، الخدمات، عمليات النشر، متغيرات البيئة، المفاتيح الخاصة، الفرق، ورمزات الوصول للسحابة (Hetzner، DigitalOcean)، والمزيد.
2. تشخيصات ذكية: diagnose_app، diagnose_server، find_issues مع مُعرفات يسهل على البشر التعامل معها.
3. عمليات مجمعة: إعادة تشغيل مشاريع كاملة، تحديثات جماعية لمتغيرات البيئة، إيقاف/إعادة نشر تطبيقات متعددة.
4. كفاءة في استخدام الرموز المميزة (Tokens): الردود أصغر بنسبة 85–99% من واجهة برمجة تطبيقات (API) Coolify الخام (على سبيل المثال، قائمة التطبيقات list_applications مُختَصرة من ~170KB إلى ~4.4KB).
5. بحث نصي كامل في الوثائق: ميزة بحث مُدمَجة ضمن أكثر من 1,500 قطعة من وثائق Coolify.
6. ردود نمط HATEOAS: تتضمن اقتراحات للإجراءات التالية وترقيم الصفحات لتوفير سياق أفضل للمساعد الذكي.
7. جاهز للإنتاج: تغطية اختبارات تفوق 98%، استخدام صارم لـ TypeScript، معالجة قوية للأخطاء.

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

1. عمليات نشر بقيادة الذكاء الاصطناعي: "انشر تطبيق Next.js الخاص بي من مستودع GitHub X إلى البيئة الإنتاجية."
2. إدارة البنية التحتية: "اعرض جميع الخوادم، أظهر استخدام الموارد، وأعد تشغيل خادم قاعدة البيانات."
3. تصحيح الأخطاء والتشخيص: "شخّص سبب فشل تطبيقي واقترح إصلاحات."
4. الإدارة المجمعة: "حدّث متغيرات البيئة عبر جميع التطبيقات في المشروع Y وأعد نشرها."
5. المساعدة في الوثائق: "ابحث في وثائق Coolify عن كيفية إعداد نسخ احتياطية لـ PostgreSQL."
6. سير عمل DevOps كاملة: اجمع هذا الخادم مع خوادم MCP أخرى لإنشاء مسارات نشر كاملة مُنسَّقة بواسطة الذكاء الاصطناعي.

التثبيت (الطريقة الأسهل)

عبر npx (مُوصَى بها لـ Claude Desktop / Cursor / Claude Code)

# لـ Claude Desktop – أضف إلى ملف claude_desktop_config.json
npx -y @masonator/coolify-mcp

عيّن متغيرات البيئة هذه:

• COOLIFY_ACCESS_TOKEN (رمز الوصول الخاص بك لواجهة برمجة تطبيقات Coolify)
• COOLIFY_BASE_URL (على سبيل المثال https://your-coolify-instance.com)

سطر أمر سريع لـ Claude Code:

claude mcp add coolify -e COOLIFY_ACCESS_TOKEN=xxx -e COOLIFY_BASE_URL=https://your-coolify.com -- npx @masonator/coolify-mcp@latest

المصدر الكامل وطرق إعداد Docker/يدوية متوفرة في المستودع.

التوافق

1. العملاء: Claude Desktop، Cursor، Claude Code، أي أداة ذكية اصطناعي متوافقة مع MCP.
2. إصدار Coolify: تم الاختبار مع الإصدار v4.0.0-beta.460+ (يكتشف الميزات تلقائيًا).
3. الترخيص: MIT

المجتمع والبدائل

هذا هو التنفيذ الأكثر صيانة نشطة وثراءً بالميزات (الإصدار 2.7.3 اعتبارًا من فبراير 2026)، المنشور في سجل MCP الرسمي. تقدم الشُعب المعززة (مثل dazeb/coolify-mcp-enhanced) أدوات نشر إضافية إذا لزم الأمر.

ابدأ إدارة منصة الخدمة البنية الذاتية (PaaS) باستخدام الذكاء الاصطناعي اليوم — يقدم خادم Coolify MCP DevOps محادثة وخالية من الجهد.