النموذج الذهني
ComfyUI MCP طبقة رقيقة موصوفة جيدًا فوق نسخة ComfyUI قيد التشغيل. تتحدّث معظم الأدوات إلى تلك النسخة عبر واجهتها البرمجية على HTTP/WebSocket، فتعمل بالطريقة نفسها سواء كان ComfyUI محليًا أو بعيدًا (--comfyui-url) أو على
Comfy Cloud (COMFYUI_API_KEY).
1
التوليد ومسارات سير العمل → واجهة ComfyUI البرمجية على HTTP
تستدعي
generate_image وenqueue_workflow وأدوات قائمة الانتظار/السجل/إحصاءات
النظام وأدوات تأليف مسارات سير العمل مسارات ComfyUI مثل /prompt و/queue
و/history و/object_info وغيرها. والإدراج في قائمة الانتظار إطلاق ونسيان:
تحصل على prompt_id فورًا وتصل النتائج عبر إشعار اكتمال. وفي وضع السحابة،
يوجّه عميل cloud-client بديل العمليات نفسها إلى cloud.comfy.org عبر
X-API-Key.2
العقد المخصّصة والنماذج → ComfyUI-Manager (HTTP)، مع تراجع إلى عملية فرعية
يفضّل تثبيت العقد وتحديثها ولقطاتها والتنصيف وتثبيت اعتماديات سير العمل واجهة
ComfyUI-Manager البرمجية على
HTTP (فتعمل ضد النسخ البعيدة أيضًا)، متراجعًا إلى
cm-cli / git /
pip/uv ضد تثبيت محلي حيث تعجز الواجهة عن أداء المهمة.3
التثبيت وعمليات نظام الملفات → محلي فقط
تثبيت ComfyUI، وتحديث النواة، وحذف ملفات النماذج، وقراءة سجلات الخادم، وسرد
مجلد المخرجات تعمل على نظام الملفات المحلي. وتتطلّب
COMFYUI_PATH معروفًا
وترجع خطأً واضحًا في الوضع البعيد أو السحابي.4
WebSocket → محلي + بعيد، لا سحابة
تُرفَق إشعارات اكتمال المهام بـ WebSocket الخاص بـ ComfyUI حيث يتوفّر. وليس
لدى Comfy Cloud WebSocket — فيتراجع مراقب المهام إلى مسار استطلاع HTTP
القائم.
قاعدة تقريبية: أي شيء يقرأ أو يشغّل الخادم المتصل يعمل في أي وضع؛ وأي شيء
يثبّت برمجيات أو يمسّ ملفات على القرص يحتاج إلى تثبيت محلي. ومصفوفة تكافؤ
الميزات الكاملة في الإعدادات ← أوضاع النشر.
الشفاء الذاتي: مراقب قائمة الانتظار/المعالجة
كانت خطوة عينات عالية الدقة المتعثّرة تدع الوكيل يكدّس المهام خلف معالجة زومبي لا يستطيع رؤيتها ولا قتلها. ثلاثة حرّاس بأفضل جهد يسدّون تلك الفجوة، فيكفّ الوكيل عن إعادة الإدراج عميانًا خلف معالجة عالقة:- الضغط الخلفي — تُلحق
panel_runتحذير QUEUE WARNING بنتيجتها حين تكون معالجة قيد التشغيل أصلًا، فلا يكدّس الوكيل خلفها. - كشف التعثّر — يتتبّع WebSocket سلبي إلى ComfyUI الموجّه / العقدة /
التقدّم الجاري؛ فخطوة تتوقّف عن التقدّم بعد العتبة
(
COMFYUI_MCP_STALL_S، الافتراضي 180 ثانية) تُصدِّر ملاحظة STALL/BACKLOG بسطر واحد إلى دور الوكيل التالي. - إلغاء متصاعد — يقاطع
queue(action:“cancel”)، ويتحقّق من أن المهمة توقّفت فعلًا (ضمنCOMFYUI_MCP_INTERRUPT_S، الافتراضي 30 ثانية)، ثم يصعّد إلى/freeويبلّغ أن المعالجة WEDGED (مقترحًاrestart_comfyui) إن لم تمت بعد؛ وclear_pendingيسقط كل المهام المعلّقة في الاستدعاء نفسه.
get_image (action:"analyze_color") (لوحة مهيمنة، ومتوسط + إحصاءات الإضاءة،
وفحوصات التباين).
فئات الأدوات
توليد الصور
تنفيذ مسارات سير العمل
تأليف مسارات سير العمل
مكتبة مسارات سير العمل
الأصول والصور
النماذج
العقد المخصّصة
عقد واجهة API
التثبيت والبيئة
التحكّم في العمليات
الافتراضيات والإحصاءات والمهارات
يُولَّد مرجع الأدوات من مخططات أدوات MCP الحيّة (
npm run docs:gen)، فلا
ينحرف عن الشيفرة أبدًا.