env الخاصة بالخادم في
~/.claude/settings.json) أو رايات سطر الأوامر. أولوية هدف ComfyUI:
--comfyui-url / COMFYUI_URL → COMFYUI_HOST/COMFYUI_PORT → الاكتشاف
التلقائي.
أوضاع النشر
يعملcomfyui-mcp في واحد من ثلاثة أوضاع، يُختار تلقائيًا من البيئة:
الأدوات التي تتطلّب تثبيتًا محليًا (
restart_comfyui مع action: "start" / apply_manifest / list_local_models (action:"remove") / get_image (action:"list_outputs") / إلخ)
ترجع خطأً واضحًا عند التشغيل في الوضع البعيد أو السحابي. وفي الوضعين البعيد والسحابي يتخطّى
الخادم الاكتشاف التلقائي لـ COMFYUI_PATH المحلي حتى لا يبتلع تثبيت محلي قديم عمليات الرفع أو
تنزيلات النماذج التي يقصدها الوكيل للهدف الفعلي — اضبط COMFYUI_PATH صراحة إن أردت
الخلط والمطابقة.
الاتصال
الرابط الكامل لنسخة ComfyUI، مثل
https://my-comfy.example.com. معادل لراية
--comfyui-url. يتقدّم على المضيف/المنفذ ويتخطّى اكتشاف المنفذ التلقائي.
يُحفَظ بادئة مسار (مثل https://host/comfyapi) حتى تُوجَّه النسخ خلف وكيل
عكسي بشكل صحيح. وحين لا يكون المضيف محليًا (أي شيء غير 127.0.0.1 / localhost /
::1 / 0.0.0.0)، يدخل الخادم في الوضع البعيد ويتخطّى الاكتشاف التلقائي لـ
COMFYUI_PATH.المسار المطلق لتثبيت ComfyUI المحلي. يُكتشَف تلقائيًا من المواقع الشائعة حين لا
يكون مضبوطًا (ويُكبت في الوضعين البعيد/السحابي). مطلوب للأدوات المحلية فقط
(تثبيت/إدارة العقد، وحذف النماذج، وقراءة السجلات، وسرد ملفات المخرجات).
جذر اختياري لمستودع الكود في التثبيتات المنقسمة، حيث تكون
main.py و.venv
منفصلة عن بيانات المستخدم والنماذج. يستخدمه pip وvenv وتحديث النواة.
تبقى قراءة/كتابة الحزم (custom_nodes) على --base-directory / COMFYUI_PATH.
يُتجاهل في الوضع البعيد.أمر shell يُعيد تشغيل ComfyUI المُدار خارجيًا — مثل
docker restart comfyui
أو systemctl --user restart comfyui. عند ضبطه، يُنفّذ restart_comfyui هذا
الأمر بدلًا من kill+relaunch (الذي يتطلب أن يكون مسار تشغيل التثبيت قابلًا
للحسم — وهو مستحيل لحاوية أو مشغّل لا يُرسَخ main.py فيه إلا داخل فضاء
الأسماء الخاص به)، ويمرّ panel_restart_comfyui عبره أيضًا. للأهداف المحلية
فقط؛ تحتفظ الأهداف البعيدة/السحابية بمسار إعادة التشغيل عبر Manager. تتحقق
إعادة التشغيل من عودة النموذج سليمًا ولا تُبلِغ عن الدورة كمؤكَّدة إلا عندما
يُرصَد down→up فعليًا.بعيد خلف وكيل عكسي / بوابة API
لتثبيت ComfyUI ذاتي الاستضافة معروض تحت بادئة مسار و/أو طبقة مصادقة خاصة به (مسار nginx، أو بوابة API، أو حافة SSO) — وهذا ليس Comfy Cloud:- يحفظ
COMFYUI_URLبادئة مسار (مثلhttps://host/comfyapi)، فتُوجَّه الطلبات تحتها بدل ضرب/promptو/system_statsو… عند الجذر. - ترفق متغيّرات
COMFYUI_AUTH_*ترويسة مصادقة عامة بـ كل طلب ComfyUI (الاستدعاءات المباشرة على HTTP ومكتبة العميل/WebSocket التحتية). وهذا مستقل عن وضع السحابة، فلا تُقرأ نسخة بمصادقة بوابة خطأً على أنها Comfy Cloud.
رمز مصادقة لتثبيت ComfyUI ذاتي الاستضافة خلف بوابة. حين يُضبَط، يُرسَل على كل
طلب ComfyUI. لا يُسجَّل أبدًا.
معرّف عميل رمز الخدمة في Cloudflare Access. اضبطه مع
CF_ACCESS_CLIENT_SECRET للوصول إلى ComfyUI أمامه Cloudflare Access — يُرسلان
كلاهما (كـ CF-Access-Client-Id / CF-Access-Client-Secret) على كل طلب
ComfyUI (HTTP وWebSocket مراقب قائمة الانتظار)، فيمرّ الموصّل بوابة Access بدل
الحصول على صفحة تسجيل الدخول التفاعلية. إضافي إلى COMFYUI_AUTH_TOKEN؛ ويأخذان
أثرهما إن ضُبطا معًا. لا يُسجَّل أبدًا.سر عميل رمز خدمة Cloudflare Access (زوج
CF_ACCESS_CLIENT_ID). لا يُرسل إلا
حين يُضبَط كلاهما — يُتجاهَل رمز نصف معدّ. لا يُسجَّل أبدًا.Comfy Cloud
ضبطCOMFYUI_API_KEY يحوّل الخادم إلى وضع السحابة: تُوجَّه كل البدائيات
المعتمدة على HTTP (الإدراج، والسجل، وإحصاءات النظام، وقائمة الانتظار، والعرض،
والرفع) إلى cloud.comfy.org عبر HTTPS بمصادقة X-API-Key؛ وتطلق أدوات WebSocket
ونظام الملفات/العمليات المحلية خطأ CLOUD_UNSUPPORTED واضحًا. ساهم
@picoSols أصلًا في المعمارية وموجّه cloud-client.
تشحن Comfy-Org أدوات وكلاء رسمية — Comfy Cloud MCP (نسخة تجريبية عامة) وComfy In-App Agent (نسخة ألفا خاصة)، يصونهما فريق Comfy ويعملان على Comfy Cloud. إن كنت تستهدف Comfy Cloud فقط، فهذا على الأرجح الخيار الصحيح؛ راجع المحلي مقابل Comfy Cloud. ووضع السحابة في
comfyui-mcp أدناه أفضل حين تريد MCP واحدًا عبر المحلي / البعيد / السحابي، أو تحتاجه اليوم (برخصة MIT ويُشحن الآن).مفتاح API لـ Comfy Cloud. حين يُضبَط، يدخل الخادم وضع السحابة ويتحدّث إلى رابط
السحابة المضبوط بدل ComfyUI محلي. لا يُسجَّل أبدًا.
الرموز
رمز API لـ CivitAI. يُستخدم للتنزيلات المحجوبة/ذات الوصول المبكر. يُرسل ترويسة
bearer (لا في الروابط أبدًا).
نقطة نهاية مرآة HuggingFace للمناطق مقيَّدة الشبكة (مثل
https://hf-mirror.com). تُعاد كتابة كل روابط واجهة huggingface.co البرمجية
والتنزيل إلى هذا المضيف؛ وما يزال HUGGINGFACE_TOKEN لديك يركب للمستودعات
المحجوبة. المتغيّر المعياري فعليًا — نفسه الذي يحترمه huggingface_hub.اضبطه على
0 لتعطيل الوصول إلى Civitai بالكامل (مناطق يتعذّر فيها الوصول إلى
civitai.com). تفشل أدوات Civitai التي يبدأها المستخدم بسرعة برسالة «معطَّل
بالإعداد» واضحة بدل التعليق؛ وتتعطّل عمليات بحث المصدر في الخلفية بهدوء.مفتاح API لـ comfy.org يُمرَّر إلى عقد الواجهة البرمجية المستضافة عبر حمولة
extra_data في /prompt. إن لم يكن متغيّر البيئة مضبوطًا، يُقرأ المفتاح من
~/.comfy-api-key (محتويات الملف بعد التشذيب؛ يُوصى بـ chmod 600) — مفيد
لإعدادات بلا واجهة تُبقي الأسرار خارج قوائم البيئة/العمليات.مفتاح API لـ Comfy Registry تستخدمه
node_pack (action: "publish") لنشر حزمة
عقد. يُمرَّر إلى comfy-cli عبر البيئة، ولا يُوضَع في الوسائط أو السجلات أبدًا.السلوك
الدليل الذي يُمسَح بحثًا عن مسارات سير عمل
*.json. ويصير كل منها أداة تشغيل
تُحمَّل تلقائيًا.تنزيلات النماذج
ذاكرة مؤقّتة معنونة بالمحتوى لتنزيلات النماذج. تعيد التنزيلات المتكرّرة أو
المتزامنة للرابط نفسه استخدام الملف المخزَّن؛ ويُجسَّد مسار النموذج الهدف عبر
رابط صلب (متراجعًا إلى النسخ).
الحجم الأقصى لذاكرة التنزيل المؤقّتة بالغيغابايت.
0 يعطّل الإخلاء؛ وفوق الحد،
تُحذف الملفات المخزَّنة الأقل استخدامًا مؤخّرًا بعد اكتمال تنزيل.عدد الاتصالات المتوازية لكل عملية تنزيل نموذج. الاتصال الواحد محدود بزمن الذهاب والإياب، وفي كثير من شبكات توزيع النماذج بحدّ سرعة لكل اتصال؛ جلب نطاقات البايت بالتوازي يتجاوز الاثنين. القيمة
1 تعطّل ذلك وتنزّل عبر اتصال واحد. لا يُستخدم إلا عندما يعلن المضيف دعم نطاقات البايت ويثبته في طلب اختبار — وإلا يجري التنزيل عبر اتصال واحد تمامًا كما كان.الحد الأدنى لحجم الملف بالميغابايت الذي يستحق التقسيم على عدة اتصالات. دون ذلك تكلّف الرحلات الإضافية أكثر مما تعيده الموازاة.
الإشراف على العمليات (التثبيتات المحلية)
ينطبق علىrestart_comfyui (الإجراءان start وrestart) حين يدير comfyui-mcp
عملية ComfyUI محلية.
الحد الأقصى لمسابير الجاهزية قبل الإبلاغ بأن البدء غير مؤكَّد. مع الفاصل
الافتراضي 1 ثانية تكون هذه ميزانية نحو 60 ثانية. رُفعت من 20 لأن ComfyUI مع
مجموعة عادية من العقد المخصّصة يستغرق روتينيًا أكثر من 20 ثانية للإجابة عن
/system_stats عند بدء بارد، وكانت الميزانية الأقصر تبلغ عن بدء غير مؤكَّد
لحظات قبل أن تصير نسخة سليمة جاهزة.استنفاد الميزانية يعني أن البدء غير مؤكَّد بعد — لا أنه فشل.حين يُفعَّل، تُعاد تشغيل عملية ComfyUI تخرج على نحو غير متوقَّع تلقائيًا. ولا
يُعاد أبدًا تشغيل
restart_comfyui متعمَّد مع action: "stop".الحد الأقصى لإعادات التشغيل التلقائية المسموح بها ضمن نافذة إعادة التشغيل قبل
التخلّي.
منسّق اللوحة والجسر
يقود الشريط الجانبي comfyui-mcp-panel منسّق اللوحة — عملية خلفية تملك جسر WebSocket على العنوان المحلي وتشغّل جلسة Claude Agent SDK مستقلة لكل تبويب لوحة على اشتراك Claude لديك (بلا مفاتيح API). وتبدأ حزمة اللوحة تشغيله تلقائيًا عند تحميل ComfyUI، لذا لا تشغّل عادة شيئًا يدويًا — راجع اللوحة الجانبية. لتشغيله بنفسك:منفذ العنوان المحلي لجسر WebSocket الخاص باللوحة الذي يملكه منسّق اللوحة
(الافتراضي 9199).
عتبة تعثّر المعالجة (ثوانٍ) لمراقب قائمة الانتظار/المعالجة لدى المنسّق: مهمة
قيد التشغيل لم يتقدّم عقدتها/تقدّمها لهذه المدة تُعلَّم بأنها متعثّرة، وتُصدَّر
ملاحظة STALL/BACKLOG بسطر واحد إلى دور الوكيل التالي. وخطوات الفيديو بطيئة
بشرعية، لذا فالافتراضي مرتفع. يُثبَّت عند 15–3600 ثانية. ويتجاوز إعداد
اللوحة تحذير تعثّر التوليد (بالثواني) (الإعدادات ← Comfy MCP Agent ← عام)
هذا حيًّا عبر إطار جسر
set_config — بلا حاجة إلى إعادة اتصال —
متقدّمًا على قيمة البيئة هذه.الجسر الآمن (قيادة Pod بعيد/سحابي)
حين يستهدفconnect <url> نسخة ComfyUI بعيدة عبر https (مثل Pod في RunPod)،
لا تستطيع صفحة اللوحة عبر HTTPS على الـ Pod فتح مقبس ws://127.0.0.1 عادي إلى
الجسر على جهازك — تحظره المتصفحات (محتوى مختلط / وصول الشبكة الخاصة). فيرقّي
المنسّق تلقائيًا إلى نفق wss:// آمن فيعمل بلا موجه، في أي متصفح. راجع
النشر السحابي للشرح الكامل والمُرحِّل ذاتي
الاستضافة لتشغيل بنية النفق الخاصة بك بدل نفق
cloudflared السريع الافتراضي.
افرض جسر
ws:// العادي على العنوان المحلي حتى عند قيادة هدف بعيد عبر https،
بدل الترقية التلقائية إلى نفق آمن. استخدم هذا إن وصلت إلى الـ Pod عبر تمرير منفذ
SSH خاص بك (فصفحته أصل عنوان محلي أصلًا) ولا تريد اعتمادًا على Cloudflare.
الأمر نفسه كـ --insecure-bridge.أي خلفية جسر آمن تُستخدم لهدف بعيد:
cloudflared (الافتراضي — نفق سريع عابر،
بلا إعداد) أو relay (اتصل بـ
مُرحِّل ذاتي الاستضافة تشغّله، لنطاق ثابت وبلا
اعتماد على نفق سريع لطرف ثالث). لا يأخذ أثره إلا حين يكون الوضع الآمن نشطًا
(هدف بعيد عبر https، وليس COMFYUI_MCP_INSECURE_BRIDGE).سرّ مشترك اختياري يقيّد من يستطيع فتح جلسة على مُرحِّلك أصلًا (
?key=)، مستقل
عن رمز الجسر لكل جلسة. لا يعني إلا في وضع المُرحِّل، وفقط إن ضبط نشر مُرحِّلك
RELAY_ACCESS_KEY.مراقبة المهام
تتتبّع إشعارات اكتمال المهام المدرجة مراقب (WebSocket حيث يتوفّر، واستطلاع HTTP وإلا).الحد الأقصى للثواني التي ينتظرها المراقب حتى تكتمل مهمة قبل التخلّي. ارفعه
لمعالجات فيديو طويلة جدًا أو مسارات عمل ثقيلة متعدّدة المراحل. (تظل المهمة
نفسها تعمل في ComfyUI — يُتخلَّى عن إشعار الاكتمال فقط).
نافذة احترام الإلغاء (ثوانٍ) لـ
queue (action:“cancel”): كم تنتظر حتى توقف
مقاطعة المهمة الجارية فعلًا قبل التصعيد (إلى /free، ثم الإبلاغ أن المعالجة
WEDGED). لا يفحص ComfyUI راية المقاطعة إلا بين العقد/الخطوات، فخطوة واحدة
لعدّة دقائق لن تحترمها فورًا — وهذا الانتظار هو ما يكشف تعثّرًا حقيقيًا.تقييد مجموعة الأدوات
لنشر مستضاف — Open WebUI مشترك، أو واجهة فريق — المشغّل ليس من يوجّه. تحجب متغيّرات الإعداد المسبق/السماح/المنع الأدوات عن النموذج بالكامل: أداة محجوبة لا تُسجَّل أبدًا، فتغيب عنtools/list، وتغيب عن call_tool، ولا يعلم النموذج أنها
موجودة. وقائمة سماح الإجراءات الرفيق الأضيق لأداة يجب أن تبقى مرئية: تظل الأداة
مسجَّلة، لكن إجراءً غير مدرج يُرفَض قبل تشغيل معالجه.
safe — كل شيء ما عدا الأدوات التي تغيّر الجهاز أو مكتبة النماذج. يُحجَب
التثبيت والحذف وإعادة التشغيل. ما تزال المعالجة تعمل، وكذلك ما يأتي معها:
إدراج عمليات التوليد، وlist_api_nodes (عقد شركاء مستضافة تنفق أرصدة
مدفوعة)، وreport_issue (تقدّم مشكلة GitHub عامة). استخدم readonly إن وجب
ألا يستطيع مستخدمو واجهة مشتركة الإنفاق أو النشر.
readonly — فحص فقط: لا تُدرَج معالجات، ولا يُكتب شيء، ولا يُنفَق شيء.
ويحجب كلاهما سطح panel_* كله، الذي يقود لوحة رسم مشتركة حيّة.أسماء أدوات مفصولة بفواصل لحجبها، مثل
restart_comfyui,download_model. و*
ختامية تطابق عائلة: train_*. تُطبَّق فوق أي إعداد مسبق وفوق قائمة سماح.قائمة سماح مفصولة بفواصل. حين تُضبَط، تكون المجموعة بالضبط هذه الأدوات —
أي شيء غير مسمّى يُحجَب حتى لو لم تذكره قاعدة منع. استخدمها لإعادة إدخال أدوات
فردية بعد إعداد مسبق:
COMFYUI_MCP_TOOL_PRESET=safe إضافةً إلى
COMFYUI_MCP_TOOL_ALLOW=panel_graph_outline,panel_query_graph.لا يعيد إدخال أداة بعد إعداد مسبق إلا اسم مطابق. يضيّق glob (list_*)
المجموعة كأي مدخل آخر لكنه لا يستطيع إعادة فتح ما أغلقه إعداد مسبق — وإلا
لأعاد ALLOW=list_* قبول list_packs، الذي يثبّت إجراء install_deps فيه
شيفرة طرف ثالث ويشغّلها، ولجعل ALLOW=* كل إعداد مسبق بلا أثر.أزواج
tool:action مطابقة مفصولة بفواصل. حين تُضبَط، يجب أن يطابق كل استدعاء
أداة يحمل حقل action واحدًا من هذه الأزواج؛ ولا تستطيع الأدوات الحاملة
لإجراء المحذوفة من القائمة إرسال أي إجراء. يقيّد هذا الأدوات المدمجة التي لم
تعد أسماؤها وحدها تكشف نصف قطر انفجارها — مثلًا، اسمح بفحص قائمة الانتظار
والإلغاء المستهدف دون السماح أيضًا بتعديلات القائمة أو مسح عام:queue:list,queue:status,queue:cancel,enqueue_workflow:enqueueاقرن هذا بـ COMFYUI_MCP_TOOL_ALLOW لتقييد البعدين. والقواعد مطابقة؛
وتُرفَض البدائل حتى لا يصير إجراء مضاف حديثًا مسموحًا بعد ترقية.A hosted deployment that cannot install or restart anything
A generation operator that can inspect, enqueue, and cancel—but not install or clear queues
النقل
يتحدث الخادم stdio افتراضيًا (ما يتوقّعه Claude Code). ويستطيع أيضًا خدمة نقل streamable-HTTP لإعدادات بعيدة/متعدّدة العملاء.Run the HTTP transport