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 صراحة إن أردت
الخلط والمطابقة.
الاتصال
string
الرابط الكامل لنسخة ComfyUI، مثل
https://my-comfy.example.com. معادل لراية
--comfyui-url. يتقدّم على المضيف/المنفذ ويتخطّى اكتشاف المنفذ التلقائي.
يُحفَظ بادئة مسار (مثل https://host/comfyapi) حتى تُوجَّه النسخ خلف وكيل
عكسي بشكل صحيح. وحين لا يكون المضيف محليًا (أي شيء غير 127.0.0.1 / localhost /
::1 / 0.0.0.0)، يدخل الخادم في الوضع البعيد ويتخطّى الاكتشاف التلقائي لـ
COMFYUI_PATH.string
افتراضي:"127.0.0.1"
مضيف خادم ComfyUI.
number
منفذ خادم ComfyUI. يُكتشَف تلقائيًا (8188، ثم 8000) حين لا يكون مضبوطًا.
boolean
افتراضي:"false"
استخدم
https/wss بدل http/ws.string
المسار المطلق لتثبيت ComfyUI المحلي. يُكتشَف تلقائيًا من المواقع الشائعة حين لا
يكون مضبوطًا (ويُكبت في الوضعين البعيد/السحابي). مطلوب للأدوات المحلية فقط
(تثبيت/إدارة العقد، وحذف النماذج، وقراءة السجلات، وسرد ملفات المخرجات).
بعيد خلف وكيل عكسي / بوابة API
لتثبيت ComfyUI ذاتي الاستضافة معروض تحت بادئة مسار و/أو طبقة مصادقة خاصة به (مسار nginx، أو بوابة API، أو حافة SSO) — وهذا ليس Comfy Cloud:- يحفظ
COMFYUI_URLبادئة مسار (مثلhttps://host/comfyapi)، فتُوجَّه الطلبات تحتها بدل ضرب/promptو/system_statsو… عند الجذر. - ترفق متغيّرات
COMFYUI_AUTH_*ترويسة مصادقة عامة بـ كل طلب ComfyUI (الاستدعاءات المباشرة على HTTP ومكتبة العميل/WebSocket التحتية). وهذا مستقل عن وضع السحابة، فلا تُقرأ نسخة بمصادقة بوابة خطأً على أنها Comfy Cloud.
string
رمز مصادقة لتثبيت ComfyUI ذاتي الاستضافة خلف بوابة. حين يُضبَط، يُرسَل على كل
طلب ComfyUI. لا يُسجَّل أبدًا.
string
افتراضي:"Authorization"
اسم الترويسة التي تحمل الرمز، مثل
X-API-Key.string
افتراضي:"Bearer for Authorization, else none"
بادئة المخطط على قيمة الرمز، مثل
Bearer، Token.string
معرّف عميل رمز الخدمة في Cloudflare Access. اضبطه مع
CF_ACCESS_CLIENT_SECRET للوصول إلى ComfyUI أمامه Cloudflare Access — يُرسلان
كلاهما (كـ CF-Access-Client-Id / CF-Access-Client-Secret) على كل طلب
ComfyUI (HTTP وWebSocket مراقب قائمة الانتظار)، فيمرّ الموصّل بوابة Access بدل
الحصول على صفحة تسجيل الدخول التفاعلية. إضافي إلى COMFYUI_AUTH_TOKEN؛ ويأخذان
أثرهما إن ضُبطا معًا. لا يُسجَّل أبدًا.string
سر عميل رمز خدمة 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 ويُشحن الآن).string
مفتاح API لـ Comfy Cloud. حين يُضبَط، يدخل الخادم وضع السحابة ويتحدّث إلى رابط
السحابة المضبوط بدل ComfyUI محلي. لا يُسجَّل أبدًا.
string
افتراضي:"https://cloud.comfy.org"
تجاوز نقطة نهاية Comfy Cloud (أساسًا للاختبار / التجهيز).
الرموز
string
رمز API لـ CivitAI. يُستخدم للتنزيلات المحجوبة/ذات الوصول المبكر. يُرسل ترويسة
bearer (لا في الروابط أبدًا).
string
رمز HuggingFace لحدود معدّل أعلى على البحث/التنزيل.
string
نقطة نهاية مرآة HuggingFace للمناطق مقيَّدة الشبكة (مثل
https://hf-mirror.com). تُعاد كتابة كل روابط واجهة huggingface.co البرمجية
والتنزيل إلى هذا المضيف؛ وما يزال HUGGINGFACE_TOKEN لديك يركب للمستودعات
المحجوبة. المتغيّر المعياري فعليًا — نفسه الذي يحترمه huggingface_hub.string
اضبطه على
0 لتعطيل الوصول إلى Civitai بالكامل (مناطق يتعذّر فيها الوصول إلى
civitai.com). تفشل أدوات Civitai التي يبدأها المستخدم بسرعة برسالة «معطَّل
بالإعداد» واضحة بدل التعليق؛ وتتعطّل عمليات بحث المصدر في الخلفية بهدوء.string
رمز GitHub تستخدمه عمليات توليد المهارات وجلب بيانات العقد الوصفية لتفادي حدود
المعدّل.
string
مفتاح API لـ comfy.org يُمرَّر إلى عقد الواجهة البرمجية المستضافة عبر حمولة
extra_data في /prompt. إن لم يكن متغيّر البيئة مضبوطًا، يُقرأ المفتاح من
~/.comfy-api-key (محتويات الملف بعد التشذيب؛ يُوصى بـ chmod 600) — مفيد
لإعدادات بلا واجهة تُبقي الأسرار خارج قوائم البيئة/العمليات.string
مفتاح API لـ Comfy Registry تستخدمه
node_pack (action: "publish") لنشر حزمة
عقد. يُمرَّر إلى comfy-cli عبر البيئة، ولا يُوضَع في الوسائط أو السجلات أبدًا.السلوك
string
افتراضي:"~/.comfyui-mcp/workflows"
الدليل الذي يُمسَح بحثًا عن مسارات سير عمل
*.json. ويصير كل منها أداة تشغيل
تُحمَّل تلقائيًا.string
افتراضي:"info"
إسهاب التسجيل:
debug، info، warn، error.تنزيلات النماذج
string
افتراضي:"~/.comfyui-mcp/cache"
ذاكرة مؤقّتة معنونة بالمحتوى لتنزيلات النماذج. تعيد التنزيلات المتكرّرة أو
المتزامنة للرابط نفسه استخدام الملف المخزَّن؛ ويُجسَّد مسار النموذج الهدف عبر
رابط صلب (متراجعًا إلى النسخ).
number
افتراضي:"0"
الحجم الأقصى لذاكرة التنزيل المؤقّتة بالغيغابايت.
0 يعطّل الإخلاء؛ وفوق الحد،
تُحذف الملفات المخزَّنة الأقل استخدامًا مؤخّرًا بعد اكتمال تنزيل.الإشراف على العمليات (التثبيتات المحلية)
ينطبق علىrestart_comfyui (الإجراءان start وrestart) حين يدير comfyui-mcp
عملية ComfyUI محلية.
number
افتراضي:"1"
الثواني بين مسابير الجاهزية بعد إطلاق ComfyUI.
number
افتراضي:"60"
الحد الأقصى لمسابير الجاهزية قبل الإبلاغ بأن البدء غير مؤكَّد. مع الفاصل
الافتراضي 1 ثانية تكون هذه ميزانية نحو 60 ثانية. رُفعت من 20 لأن ComfyUI مع
مجموعة عادية من العقد المخصّصة يستغرق روتينيًا أكثر من 20 ثانية للإجابة عن
/system_stats عند بدء بارد، وكانت الميزانية الأقصر تبلغ عن بدء غير مؤكَّد
لحظات قبل أن تصير نسخة سليمة جاهزة.استنفاد الميزانية يعني أن البدء غير مؤكَّد بعد — لا أنه فشل.boolean
افتراضي:"false"
حين يُفعَّل، تُعاد تشغيل عملية ComfyUI تخرج على نحو غير متوقَّع تلقائيًا. ولا
يُعاد أبدًا تشغيل
restart_comfyui متعمَّد مع action: "stop".number
افتراضي:"3"
الحد الأقصى لإعادات التشغيل التلقائية المسموح بها ضمن نافذة إعادة التشغيل قبل
التخلّي.
number
افتراضي:"60"
نافذة منزلقة (ثوانٍ) تُعدّ عليها محاولات إعادة التشغيل التلقائية.
منسّق اللوحة والجسر
يقود الشريط الجانبي comfyui-mcp-panel منسّق اللوحة — عملية خلفية تملك جسر WebSocket على العنوان المحلي وتشغّل جلسة Claude Agent SDK مستقلة لكل تبويب لوحة على اشتراك Claude لديك (بلا مفاتيح API). وتبدأ حزمة اللوحة تشغيله تلقائيًا عند تحميل ComfyUI، لذا لا تشغّل عادة شيئًا يدويًا — راجع اللوحة الجانبية. لتشغيله بنفسك:boolean
افتراضي:"false"
شغّل منسّق اللوحة بدل خادم MCP (الأمر نفسه كـ
--panel-orchestrator).string
افتراضي:"claude-opus-5"
النموذج لوكلاء اللوحة في الخلفية.
number
افتراضي:"9180"
منفذ العنوان المحلي لجسر WebSocket الخاص باللوحة الذي يملكه منسّق اللوحة
(الافتراضي 9180).
number
افتراضي:"180"
عتبة تعثّر المعالجة (ثوانٍ) لمراقب قائمة الانتظار/المعالجة لدى المنسّق: مهمة
قيد التشغيل لم يتقدّم عقدتها/تقدّمها لهذه المدة تُعلَّم بأنها متعثّرة، وتُصدَّر
ملاحظة 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 السريع الافتراضي.
boolean
افتراضي:"false"
افرض جسر
ws:// العادي على العنوان المحلي حتى عند قيادة هدف بعيد عبر https،
بدل الترقية التلقائية إلى نفق آمن. استخدم هذا إن وصلت إلى الـ Pod عبر تمرير منفذ
SSH خاص بك (فصفحته أصل عنوان محلي أصلًا) ولا تريد اعتمادًا على Cloudflare.
الأمر نفسه كـ --insecure-bridge.string
افتراضي:"cloudflared"
أي خلفية جسر آمن تُستخدم لهدف بعيد:
cloudflared (الافتراضي — نفق سريع عابر،
بلا إعداد) أو relay (اتصل بـ
مُرحِّل ذاتي الاستضافة تشغّله، لنطاق ثابت وبلا
اعتماد على نفق سريع لطرف ثالث). لا يأخذ أثره إلا حين يكون الوضع الآمن نشطًا
(هدف بعيد عبر https، وليس COMFYUI_MCP_INSECURE_BRIDGE).string
رابط
wss:// لمُرحِّلك. مطلوب حين COMFYUI_MCP_TUNNEL_BACKEND=relay.string
سرّ مشترك اختياري يقيّد من يستطيع فتح جلسة على مُرحِّلك أصلًا (
?key=)، مستقل
عن رمز الجسر لكل جلسة. لا يعني إلا في وضع المُرحِّل، وفقط إن ضبط نشر مُرحِّلك
RELAY_ACCESS_KEY.مراقبة المهام
تتتبّع إشعارات اكتمال المهام المدرجة مراقب (WebSocket حيث يتوفّر، واستطلاع HTTP وإلا).number
افتراضي:"1800"
الحد الأقصى للثواني التي ينتظرها المراقب حتى تكتمل مهمة قبل التخلّي. ارفعه
لمعالجات فيديو طويلة جدًا أو مسارات عمل ثقيلة متعدّدة المراحل. (تظل المهمة
نفسها تعمل في ComfyUI — يُتخلَّى عن إشعار الاكتمال فقط).
number
افتراضي:"2"
الثواني بين استطلاعات سجل HTTP أثناء مراقبة مهمة.
number
افتراضي:"30"
نافذة احترام الإلغاء (ثوانٍ) لـ
queue (action:“cancel”): كم تنتظر حتى توقف
مقاطعة المهمة الجارية فعلًا قبل التصعيد (إلى /free، ثم الإبلاغ أن المعالجة
WEDGED). لا يفحص ComfyUI راية المقاطعة إلا بين العقد/الخطوات، فخطوة واحدة
لعدّة دقائق لن تحترمها فورًا — وهذا الانتظار هو ما يكشف تعثّرًا حقيقيًا.تقييد مجموعة الأدوات
لنشر مستضاف — Open WebUI مشترك، أو واجهة فريق — المشغّل ليس من يوجّه. تحجب متغيّرات الإعداد المسبق/السماح/المنع الأدوات عن النموذج بالكامل: أداة محجوبة لا تُسجَّل أبدًا، فتغيب عنtools/list، وتغيب عن call_tool، ولا يعلم النموذج أنها
موجودة. وقائمة سماح الإجراءات الرفيق الأضيق لأداة يجب أن تبقى مرئية: تظل الأداة
مسجَّلة، لكن إجراءً غير مدرج يُرفَض قبل تشغيل معالجه.
string
safe — كل شيء ما عدا الأدوات التي تغيّر الجهاز أو مكتبة النماذج. يُحجَب
التثبيت والحذف وإعادة التشغيل. ما تزال المعالجة تعمل، وكذلك ما يأتي معها:
إدراج عمليات التوليد، وlist_api_nodes (عقد شركاء مستضافة تنفق أرصدة
مدفوعة)، وreport_issue (تقدّم مشكلة GitHub عامة). استخدم readonly إن وجب
ألا يستطيع مستخدمو واجهة مشتركة الإنفاق أو النشر.
readonly — فحص فقط: لا تُدرَج معالجات، ولا يُكتب شيء، ولا يُنفَق شيء.
ويحجب كلاهما سطح panel_* كله، الذي يقود لوحة رسم مشتركة حيّة.string
أسماء أدوات مفصولة بفواصل لحجبها، مثل
restart_comfyui,download_model. و*
ختامية تطابق عائلة: train_*. تُطبَّق فوق أي إعداد مسبق وفوق قائمة سماح.string
قائمة سماح مفصولة بفواصل. حين تُضبَط، تكون المجموعة بالضبط هذه الأدوات —
أي شيء غير مسمّى يُحجَب حتى لو لم تذكره قاعدة منع. استخدمها لإعادة إدخال أدوات
فردية بعد إعداد مسبق:
COMFYUI_MCP_TOOL_PRESET=safe إضافةً إلى
COMFYUI_MCP_TOOL_ALLOW=panel_graph_outline,panel_query_graph.لا يعيد إدخال أداة بعد إعداد مسبق إلا اسم مطابق. يضيّق glob (list_*)
المجموعة كأي مدخل آخر لكنه لا يستطيع إعادة فتح ما أغلقه إعداد مسبق — وإلا
لأعاد ALLOW=list_* قبول list_packs، الذي يثبّت إجراء install_deps فيه
شيفرة طرف ثالث ويشغّلها، ولجعل ALLOW=* كل إعداد مسبق بلا أثر.string
أزواج
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 لإعدادات بعيدة/متعدّدة العملاء.string
افتراضي:"stdio"
stdio أو http. الرايات المعادلة: --stdio، --http.string
افتراضي:"127.0.0.1"
مضيف ربط HTTP (مع
--http). الراية: --host.number
افتراضي:"9100"
منفذ ربط HTTP (مع
--http). الراية: --port.Run the HTTP transport