/ الدليل / الملعب / coolify-mcp
← كل الخوادم ↗ GitHub
● مجتمع StuMason ⚡ فوري

coolify-mcp

بواسطة StuMason · StuMason/coolify-mcp

أدِر Coolify PaaS ذاتية الاستضافة من خلال الحوار — انشر التطبيقات، وأطلق قواعس البيانات، وراقب السجلات، وعدّل متغيرات البيئة — باستخدام 38 أداة معدلة للعمل في نوافذ سياق صغيرة.

Coolify MCP هو خادم TypeScript يغلف API Coolify بـ 38 أداة فعالة موجهة للسياق. تم تقليل الاستجابات بنسبة 90-99% مقارنة بـ API الخام، حتى تتمكن من إجراء محادثة نشر فعلية دون انهيار السياق. مثالي للمسؤولين الذاتيين الذين يريدون ChatOps بدون التعقيدات العملياتية.

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

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

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

عرض مباشر

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

coolify.replay ▶ جاهز
0/0

التثبيت

اختر العميل

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

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

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

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

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

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

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

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

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

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

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

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

claude mcp add coolify -- npx -y coolify-mcp

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

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

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

نشر تطبيق جديد على Coolify من رابط Git عبر الحوار

👤 المطورون المستقلون والمختبرون المستقلون الذين يستضيفون خوادمهم الخاصة ⏱ ~10 min beginner

متى تستخدمه: لديك مشروع جانبي جديد على GitHub وتريده مباشراً على خادم VPS الخاص بك في أقل من 5 دقائق دون النقر عبر واجهة Coolify.

المتطلبات الأساسية
  • مثيل Coolify قيد التشغيل — نص تثبيت coolify.io على خادم VPS الخاص بك
  • COOLIFY_ACCESS_TOKEN — Coolify > الإعدادات > API > إنشاء رمز
الخطوات
  1. إنشاء التطبيق
    إنشاء تطبيق Coolify جديد في المشروع 'side-projects' على الخادم 'hetzner-fsn1'. المصدر: https://github.com/me/my-app. حزمة البناء: Nixpacks. المنفذ: 3000.✓ تم النسخ
    → تم إنشاء التطبيق مع إرجاع UUID
  2. تعيين متغيرات البيئة
    عيّن متغيرات البيئة على التطبيق: DATABASE_URL=...، SESSION_SECRET=...، NODE_ENV=production.✓ تم النسخ
    → تم حفظ متغيرات البيئة
  3. النشر ومراقبة السجلات
    انشر التطبيق. تتبّع سجل البناء؛ أخبرني عندما يكون سليماً أو إذا تعطل.✓ تم النسخ
    → سجل البناء المباشر + القرار النهائي للنجاح أو الفشل

النتيجة: تطبيق HTTPS جديد يعمل على خادم VPS الخاص بك في حوالي 5 دقائق، كل شيء من خلال الحوار.

المزالق
  • نسيت تعيين نطاق؛ يستخدم Coolify نطاق مولد تلقائياً غير جميل — بعد النشر، اطلب: 'أضف نطاق مخصص app.example.com مع HTTPS'. سيوفر Coolify Let's Encrypt تلقائياً.
اجمعها مع: github

إنشاء قاعدة بيانات Postgres مدارة لتطبيقك الجديد في طلب واحد

👤 مطورو كامل المكدس ⏱ ~5 min beginner

متى تستخدمه: يحتاج تطبيقك إلى قاعدة بيانات ولا تريد الدخول إلى shell و docker run وتذكر جدولة النسخ الاحتياطي.

الخطوات
  1. إنشاء قاعدة البيانات
    إنشاء قاعدة بيانات Postgres 16 باسم 'myapp-prod' في المشروع 'side-projects' بذاكرة 2 جيجابايت، مع النسخ الاحتياطية اليومية المحتفظ بها لمدة 7 أيام.✓ تم النسخ
    → تم إنشاء قاعدة البيانات، وتم إرجاع بيانات المصادقة
  2. ربطها بتطبيقك
    أضف DATABASE_URL لقاعدة البيانات هذه كمتغير بيئة على التطبيق 'my-app'، وأعد النشر.✓ تم النسخ
    → تم تعيين متغير البيئة + تم تشغيل إعادة النشر

النتيجة: قاعدة بيانات Postgres مدارة مع نسخ احتياطية مجدولة، متصلة بتطبيقك.

المزالق
  • يقبل Postgres الافتراضي الاتصالات فقط من شبكة Coolify — عيّن تبديل Public عبر MCP إذا كنت بحاجة إلى وصول خارجي — وافتح فقط عناوين IP محددة
اجمعها مع: postgres

تشخيص واستعادة من انهيار تطبيق الإنتاج من هاتفك

👤 العاملون المستقلون بالعمليات، الفرق الصغيرة ⏱ ~10 min intermediate

متى تستخدمه: تطبيقك معطل وأنت بعيد عن مكتبك. لديك Claude على هاتفك ورمز Coolify الخاص بك.

الخطوات
  1. التحقق من الحالة
    أظهر لي حالة جميع التطبيقات في المشروع 'prod'. هل هناك أي شيء غير صحي؟✓ تم النسخ
    → قائمة حالة لكل تطبيق مع تحديد الحالات الحرجة
  2. الاطلاع على السجلات
    اعرض آخر 200 سطر من سجل التطبيق 'api-server'. ما الخطأ؟✓ تم النسخ
    → مقتطف من السجل + السبب المحتمل
  3. الرجوع أو إعادة التشغيل
    أعد تشغيل التطبيق. إذا تعطل مرة أخرى في غضون دقيقتين، أعد نشر الإصدار السابق.✓ تم النسخ
    → تم إصدار أمر إعادة التشغيل؛ تم مراقبة الحالة

النتيجة: خدمة معافاة دون الحاجة إلى جهاز محمول.

المزالق
  • إعادة التشغيل لن تصلح النشر السيء — ستدخل في حلقة — اطلب من Claude أن ينظر إلى سجل النشر والعودة إلى آخر إصدار صحي إذا لم تساعد إعادة التشغيل
اجمعها مع: sentry

تدوير سر مشترك عبر كل تطبيق في مشروع

👤 فرق DevOps الصغيرة ⏱ ~10 min intermediate

متى تستخدمه: قمت بتدوير مفتاح API (Stripe أو Sentry DSN وما إلى ذلك) و 6 تطبيقات تشير إليه.

الخطوات
  1. قائمة التطبيقات المتأثرة
    في المشروع 'prod'، اعرض جميع التطبيقات التي تحتوي على متغير البيئة 'STRIPE_SECRET_KEY'.✓ تم النسخ
    → قائمة التطبيقات المطابقة
  2. التحديث الجماعي وإعادة النشر
    حدّث STRIPE_SECRET_KEY إلى [القيمة الجديدة] على جميع هذه التطبيقات، ثم قم بتشغيل إعادة النشر لكل منها بتأخير 30 ثانية.✓ تم النسخ
    → تقرير التحديث والنشر لكل تطبيق

النتيجة: تدوير السر على مستوى الأسطول في محادثة واحدة.

المزالق
  • إعادة النشر المتدرجة لا تزال تسبب توقف مؤقت — إذا كان توقف صفري مطلوباً، استخدم نمط النشر المتسلسل من Coolify لكل تطبيق

التركيبات

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

coolify + github

عندما يكون مستودع جديد جاهزاً، انشره على Coolify وأضف تعليق برابط المعاينة على طلب الدمج

خذ مستودع me/new-project. انشره على Coolify تحت المشروع 'preview'، ثم أضف تعليق برابط المعاينة على README للفرع الرئيسي.✓ تم النسخ
coolify + sentry

عندما يُظهر Sentry ارتفاعاً في تطبيق مستضاف على Coolify، أعد نشر الإصدار السابق

إذا تضاعف عدد مشاكل Sentry للتطبيق 'api-server' في 10 دقائق، عد إلى آخر إصدار من Coolify.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
list_servers اكتشف الخوادم المرفقة قبل إنشاء الموارد 1 API call
list_applications project_uuid?: str ابحث عن التطبيقات الموجودة؛ حدّد نطاق المشروع للحصول على ضوضاء أقل 1 API call
create_application source, server, project, build_pack, port, ... أنشئ تطبيق جديد من Git 1 API call
deploy_application app_uuid: str ابدأ النشر؛ يعود فوراً، تحقق من الحالة 1 API call + build time
get_application_logs app_uuid, tail?: int صحح أخطاء تطبيق قيد التشغيل أو فاشل 1 API call
update_env_variable app_uuid, key, value, is_preview?: bool غيّر متغير البيئة؛ لا يعيد النشر تلقائياً 1 API call
create_database engine, name, project, server, config وفّر قاعدة بيانات مدارة جديدة (Postgres أو MySQL أو Redis أو MongoDB وغيرها) 1 API call
search_docs query: str ابحث عن استخدام ميزات Coolify دون مغادرة الحوار free

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

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

حصة API
محدود بمثيل Coolify — لا يوجد حد رسمي للمعدل، لكن حافظ على الاستدعاءات معقولة
الرموز لكل استدعاء
استدعاءات القائمة ~500-2000 رمز (محسّنة)؛ استدعاءات التفاصيل ~200-1000
التكلفة المالية
مجاني، MIT. Coolify نفسه مجاني وذاتي الاستضافة.
نصيحة
استخدم search_docs قبل التخمين — إنه أرخص من محاولة Claude التجربة والخطأ لميزة غير متأكد منها.

الأمان

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

الحد الأدنى من الصلاحيات: رمز API Coolify محدود النطاق للفريق الذي تريد إدارته
تخزين بيانات الاعتماد: متغير البيئة COOLIFY_ACCESS_TOKEN على الجهاز الذي يشغل عميل MCP
نقل البيانات الخارجي: مباشر إلى مثيل Coolify الخاص بك؛ يتعامل Coolify مع كل شيء آخر
لا تمنح أبدًا: مشاركة الرمز — فهو يعادل السيطرة الكاملة على PaaS الخاص بك

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

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

401 Unauthorized

الرمز غير صحيح أو انتهت صلاحيته. أعد الإنشاء في Coolify > الإعدادات > API وحدّث متغير البيئة.

تحقق: curl -H 'Authorization: Bearer $TOKEN' $COOLIFY_URL/api/v1/servers
Deploy stuck in 'queued'

تحقق مما إذا كان خادم Coolify لديه CPU / قرص حر. تأكد أيضاً من أن قائمة الانتظار للبناء لم تُعطل من خلال نشر سابق معلق.

تحقق: استخدم أداة `list_deployments` والغِ الأداة القديمة
create_application returns 422 build_pack invalid

القيم الصحيحة هي: nixpacks و static و dockerfile و dockercompose. حساسة لحالة الأحرف.

Custom domain shows cert error

يجب أن تشير DNS إلى خادم Coolify قبل إصدار TLS. تحقق من سجل A، ثم اطلب من Claude تشغيل إعادة محاولة إصدار LE.

تحقق: dig app.example.com

البدائل

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

البديلمتى تستخدمهاالمقايضة
Dokploy MCPأنت على Dokploy بدلاً من Coolifyمجموعة ميزات متشابهة؛ Dokploy هو أقرب منافس
Caprover / Dokku CLI via ssh-managerتستخدم Caprover أو Dokku وليس لديك MCP مخصصالتحكم عبر أوامر SSH؛ أقل راحة لكن يعمل في أي مكان

المزيد

الموارد

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

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

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