التثبيت - ComfyUI MCP

1. تثبيت ComfyUI

ComfyUI Desktop

أسهل طريقة للحصول على تثبيت مُدار على macOS / Windows.

من المصدر

استنسخ المستودع وشغّله يدويًا — أو استخدم أداة install_comfyui.

2. إضافة خادم MCP

يُنشر ComfyUI MCP على npm باسم comfyui-mcp ويعمل عبر npx — دون حاجة إلى تثبيت عام.

ComfyUI محلي
ComfyUI بعيد
Comfy Cloud

يكتشف الخادم التثبيت المحلي ومنفذه تلقائيًا. أضِفه إلى ~/.claude/settings.json:

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"]
    }
  }
}

وجّه الخادم إلى أي نسخة يمكن الوصول إليها عبر --comfyui-url. لا يلزم أي تثبيت محلي للأدوات القائمة على HTTP (التوليد، وقائمة الانتظار، ومسارات سير العمل، والبحث عن النماذج، وغيرها). وعندما لا يكون المضيف على العنوان المحلي (loopback)، يدخل الخادم في الوضع البعيد ويتخطّى الاكتشاف التلقائي لـ COMFYUI_PATH حتى لا يبتلع تثبيت محلي قديم عمليات الرفع بصمت.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp", "--comfyui-url", "https://my-comfy.example.com"]
    }
  }
}

تعمل معظم الأدوات بلا مشكلة مع ComfyUI بعيد — بما في ذلك تثبيت العقد المخصّصة، عبر واجهة ComfyUI-Manager البرمجية على HTTP. أما ما يحتاج فعلًا إلى مسار تثبيت محلي فهو تثبيت ComfyUI نفسه، والعمليات المعتمدة على comfy-cli، وقراءة السجلات، وحذف ملفات النماذج؛ وهذه تُرجع خطأً واضحًا في الوضع البعيد. راجع كيف يعمل.

استهدف Comfy Cloud بضبط COMFYUI_API_KEY. عندها يدخل الخادم في وضع السحابة: تُوجَّه عمليات HTTP الأساسية عبر cloud.comfy.org مع مصادقة X-API-Key. أما الأدوات المرتبطة بـ WebSocket وأدوات نظام الملفات أو العمليات المحلية فتُطلق خطأً واضحًا هو CLOUD_UNSUPPORTED.

{
  "mcpServers": {
    "comfyui": {
      "command": "npx",
      "args": ["-y", "comfyui-mcp"],
      "env": {
        "COMFYUI_API_KEY": "your-comfy-cloud-api-key"
      }
    }
  }
}

يتخطّى وضع السحابة الاكتشاف التلقائي لـ COMFYUI_PATH المحلي ويستخدم مكتبة النماذج الخاصة بالسحابة. الأدوات التي تحتاج إلى عملية محلية أو إلى نظام الملفات تُطلق CLOUD_UNSUPPORTED؛ أما غيرها فيتراجع أداؤه بدل أن يُطلق خطأً — إذ يُرجع list_local_models قائمة فارغة، ويبلّغ apply_manifest عن skipped/failed لكل عنصر بدلًا من الفشل الكامل. راجع صفحة الإعدادات للاطلاع على مصفوفة تكافؤ الميزات الكاملة.

السحابة وحدها؟ Comfy Cloud MCP من Comfy-Org (نسخة تجريبية عامة) هو الخيار المعياري — راجع محلي مقابل Comfy Cloud. استخدم وضع السحابة في comfyui-mcp إن أردت خادم MCP واحدًا يغطي المحلي والبعيد والسحابي، أو إن كنت تحتاج دعم السحابة اليوم.

ثم شغّل /mcp في Claude Code للاتصال.

3. تشغيل منسّق اللوحة

مطلوب فقط من أجل لوحة الشريط الجانبي. تخطَّ هذه الخطوة إن كنت تشغّل ComfyUI من Claude Code أو من عميل MCP آخر — فذلك المسار يستخدم خادم MCP المضبوط أعلاه. اللوحة امتداد لـ ComfyUI يعمل في الواجهة الأمامية فقط: لا يمكنها بدء أي عملية على جهازك، لذا تبدأ أنت المنسّق بنفسك وتتصل به اللوحة.

npx -y comfyui-mcp@latest connect

هذا اختصار لـ --panel-orchestrator. فهو يستهدف تلقائيًا نسخة ComfyUI المفتوحة في متصفحك، ويقدّم الجسر على ws://127.0.0.1:9180 (يمكن تجاوزه بـ COMFYUI_MCP_BRIDGE_PORT)، ويجب أن يظل قيد التشغيل ما دمت تستخدم اللوحة. ثم افتح تبويب الوكيل، واختر مزوّدًا، وانقر اتصال. هل تشغّل ComfyUI بعيدًا — على Pod سحابي أو جهاز آخر في شبكتك المحلية؟ شغّل الأمر نفسه على جهازك أنت، لا على الجهاز البعيد، ومرّر الرابط:

npx -y comfyui-mcp@latest connect https://your-pod-url

يبقى تسجيل دخولك لدى المزوّد ويبقى الوكيل محليَّين؛ ولا يُثبَّت شيء على المضيف البعيد. راجع النشر السحابي لتفاصيل النفق.

4. (اختياري) رموز API

تستخدم بعض الأدوات رموز API. اضبطها في كتلة env الخاصة بالخادم (راجع الإعدادات):

CIVITAI_API_TOKEN — تنزيلات CivitAI المحجوبة
HUGGINGFACE_TOKEN — حدود معدّل أعلى على HuggingFace
GITHUB_TOKEN — توليد المهارات / جلب بيانات العقد الوصفية
COMFY_API_KEY — عقد واجهة comfy.org البرمجية المستضافة

التطوير المحلي

يستخدم المشروع npm link بحيث يشير npx comfyui-mcp إلى نسختك المبنيّة محليًا:

git clone https://github.com/artokun/comfyui-mcp
cd comfyui-mcp
npm install
npm run build
npm link

بعد تعديل الشيفرة: شغّل npm run build، ثم /mcp لإعادة الاتصال.

​1. تثبيت ComfyUI

ComfyUI Desktop

من المصدر

​2. إضافة خادم MCP

​3. تشغيل منسّق اللوحة

​4. (اختياري) رموز API

​التطوير المحلي

1. تثبيت ComfyUI

2. إضافة خادم MCP

3. تشغيل منسّق اللوحة

4. (اختياري) رموز API

التطوير المحلي