Comfyui Flux Svd

خادم وسائط متقدم يربط نماذج الذكاء الاصطناعي بمحرك ComfyUI لتوليد الصور والفيديو

English | العربية

---

🇸🇦 نظرة عامة (العربية)

ComfyUI FLUX & SVD MCP Hub هو خادم محلي متطور مبني وفق معيار Model Context Protocol (MCP)، يتيح لنماذج الذكاء الاصطناعي التوليدية التحكم الكامل بمحرك ComfyUI لإنشاء الصور السينمائية الفائقة بنماذج مثل FLUX.1-Dev / Schnell، بالإضافة إلى تحريك الصور الثابتة إلى مقاطع فيديو قصيرة عبر نموذج Stable Video Diffusion (SVD).

🎯 القيمة التقنية

بدلاً من الدخول اليدوي إلى واجهات العقد المعقدة (Node Graph)، يوفر هذا الخادم واجهة برمجية موحدة تُمكن العميل الذكي من استدعاء خطوط الإنتاج الجاهزة، حقن النصوص التوليدية، ضبط الأبعاد وخطوات الرندر، وتتبع تقدم المعالجة لحظياً عبر بروتوكول الويب سوكيت.

---

🚀 المميزات التقنية

• توليد الصور المتقدم (Text-to-Image): دعم جاهز لمسارات العمل المعتمدة على FLUX وSDXL بجودات تصل إلى 4K.
• تحريك الفيديو (Image-to-Video): مسار عمل مخصص لتحويل اللوحات التوليدية إلى مشاهد فيديو ديناميكية باستخدام SVD.
• تتبع فوري للعمليات (Websocket Monitoring): مراقبة تقدم خط الإنتاج واستقبال رسائل تقدم الرندر خطوة بخطوة وإرسال روابط النتيجة فور جهوزيتها.
• إدارة الطوابير والأخطاء: التعامل الآمن مع أخطاء السيرفر عند امتلاء ذاكرة الفيديو (OOM) مع فحص اتصال ComfyUI التلقائي.

---

🛠️ الأدوات المتاحة (Tools)

الأداة	الوظيفة
generate_image_flux	إرسال پرومبت لتوليد صورة بدقة وأبعاد قابلة للتخصيص عبر نموذج FLUX.
animate_image_svd	أخذ مسار صورة محلية وتحويلها إلى مقطع فيديو متحرك.
check_generation_status	فحص حالة الطابور ورقم العملية الحالية داخل محرك ComfyUI.

---

⚙️ التثبيت والتشغيل

1. تثبيت المتطلبات: pip install -r requirements.txt

2. تشغيل السيرفر: python comfyui_mcp_hub.py سيعمل السيرفر على المنفذ 8000.

3. ضبط إعدادات العميل (MCP Client): منفذ الاتصال المحلي الافتراضي هو: http://127.0.0.1:8000

---

🇬🇧 Overview (English)

ComfyUI FLUX & SVD MCP Hub is an advanced local bridge implementing the Model Context Protocol (MCP) to allow Large Language Models to autonomously trigger and supervise visual generation pipelines on ComfyUI.

🎯 Key Architectural Strengths

• FLUX-Ready Pipelines: Standardized node graph injection for high-fidelity text-to-image synthesis.
• SVD Animation Support: Native Image-to-Video conversion for transforming rendered images into video clips.
• Realtime Websocket Feedback: Listens to ComfyUI execution hooks, tracking rendering steps and returning local artifact paths.
• Robust Error Mitigation: Gracefully captures node failures, disconnection issues, and VRAM memory boundaries.

---

🛠️ Exposed MCP Tools

Tool	Purpose
generate_image_flux	Submits prompts to render images with custom aspect ratios via FLUX.
animate_image_svd	Ingests a local image path and generates an animated video clip using SVD.
check_generation_status	Returns active queue positions and execution states from ComfyUI.

---

⚙️ Installation & Usage

1. Install dependencies: pip install -r requirements.txt

2. Launch server: python comfyui_mcp_hub.py Listens by default on: http://127.0.0.1:8000

3. Connect your MCP client to: http://127.0.0.1:8000

---

📄 License

Open source under the MIT License.