/ الدليل / الملعب / ComfyUI MCP Server
● مجتمع joenorton 🔑 يتطلب مفتاحك

ComfyUI MCP Server

بواسطة joenorton · joenorton/comfyui-mcp-server

ComfyUI المحلي كأداة MCP - يمكنك إنشاء الصور والصوت والفيديو وتشغيل سير العمل وإدارة الأصول دون فتح ComfyUI UI.

يقوم comfyui-mcp-server بتوصيل ComfyUI قيد التشغيل محليًا (المنفذ 8188) إلى أي عميل MCP. يمكن للوكلاء إنشاء الصور وإعادة إنشائها، وإرسال مسارات عمل مخصصة، واستقصاء الوظائف وإلغائها، وعرض الأصول التي تم إنشاؤها، وتبديل النماذج، ونشر المخرجات - كل ذلك عبر أدوات MCP. مفيد للعمل الإبداعي التكراري، وإنشاء الدُفعات، ومسارات البرامج الآلية التي يتم تشغيلها حيث لا تريد سحب العقد يدويًا.

لماذا تستخدمه

الميزات الأساسية

عرض مباشر

كيف يبدو في الممارسة

comfyui-mcp-server.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

افتح Claude Desktop → Settings → Developer → Edit Config. أعد التشغيل بعد الحفظ.

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

يستخدم Cursor نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "Edit Configuration".

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "comfyui-mcp-server": {
      "command": "python",
      "args": [
        "server.py"
      ],
      "_inferred": false,
      "env": {
        "COMFYUI_URL": "http://127.0.0.1:8188"
      }
    }
  }
}

نفس الصيغة مثل Claude Desktop. أعد تشغيل Windsurf لتطبيق التغييرات.

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "comfyui-mcp-server",
      "command": "python",
      "args": [
        "server.py"
      ]
    }
  ]
}

يستخدم Continue مصفوفة من كائنات الخادم بدلاً من خريطة.

~/.config/zed/settings.json
{
  "context_servers": {
    "comfyui-mcp-server": {
      "command": {
        "path": "python",
        "args": [
          "server.py"
        ]
      }
    }
  }
}

أضف إلى context_servers. يعيد Zed التحميل تلقائيًا عند الحفظ.

claude mcp add comfyui-mcp-server -- python server.py

أمر من سطر واحد. تحقق باستخدام claude mcp list. احذف باستخدام claude mcp remove.

حالات الاستخدام

استخدامات عملية: ComfyUI MCP Server

تكرار مفهوم الصورة مع المطالبات النصية

👤 المصممون والفنانون يستخدمون ComfyUI محليًا ⏱ ~20 min intermediate

متى تستخدمه: لقد قمت بإعداد ComfyUI ولكنك تريد التكرار عبر الدردشة بدلاً من الرسوم البيانية للعقدة.

المتطلبات الأساسية
  • ComfyUI يعمل على المنفذ 8188 — اتبع تثبيت ComfyUI؛ تأكد من وجود نموذج نقطة التفتيش في النماذج/نقاط التفتيش/
  • بدأ خادم MCP — python server.py (يستمع إلى http://127.0.0.1:9000/mcp)
الخطوات
  1. توليد الإصدار 1
    إنشاء صورة: صورة حقيقية، ضوء ملبد بالغيوم، 1024×1280.✓ تم النسخ
    → تم تقديم الوظيفة؛ عاد الهوية؛ تظهر الصورة عند الانتهاء
  2. تجديد مع القرص
    تجدد من تلك البذرة – نغمات أكثر دفئًا قليلاً، حافظ على التركيبة.✓ تم النسخ
    → نفس التركيبة والألوان الدافئة
  3. عرض + نشر
    عرض أحدث صورة. قم بنشره في المعرض باسم "portrait-final.png".✓ تم النسخ
    → البيانات الوصفية للأصول + عنوان URL للنشر

النتيجة: التكرار السريع دون النقر فوق العقد.

المزالق
  • يجب تشغيل نسيان ComfyUI قبل بدء تشغيل خادم MCP — ابدأ تشغيل ComfyUI أولاً، ثم خادم MCP
اجمعها مع: filesystem

ابدأ سير عمل ComfyUI المحفوظ من الدردشة

👤 فرق ذات سير عمل ComfyUI راسخة ⏱ ~15 min intermediate

متى تستخدمه: لقد قمت بالفعل ببناء سير العمل؛ الآن تريد تشغيله برمجيا.

المتطلبات الأساسية
  • سير عمل محفوظ في ComfyUI — حفظ باسم → سير العمل JSON
الخطوات
  1. قائمة سير العمل
    قائمة سير العمل الخاص بي.✓ تم النسخ
    → صفيف مع الأسماء/المعرفات
  2. تشغيله
    قم بتشغيل 'product-shot-v3' باستخدام إيجابي='كوب سيراميك على رخام'، سلبي='ضبابية'.✓ تم النسخ
    → تم إنشاء الوظيفة؛ رددت المعلمات
  3. انتظر + احصل على النتيجة
    أخبرني عندما ينتهي وأظهر الصورة.✓ تم النسخ
    → قائمة انتظار الاقتراع؛ إرجاع الأصول عند اكتمالها

النتيجة: تنسيق سير العمل من الدردشة — مثالي لعمليات التشغيل المجمعة.

المزالق
  • يشير سير العمل إلى العقد المخصصة غير المثبتة — قم بتثبيت العقد المخصصة المطلوبة في ComfyUI قبل التشغيل
اجمعها مع: comfy-pilot

قم بتحويل نص قصير إلى فيديو باستخدام سير عمل الفيديو

👤 يقوم منشئو المحتوى بإنتاج مقاطع قصيرة ⏱ ~45 min advanced

متى تستخدمه: لديك سير عمل فيديو ComfyUI (على سبيل المثال، AnimateDiff / Mochi) وتريد تغذية المطالبات بشكل تسلسلي.

الخطوات
  1. تحميل سير عمل الفيديو
    قم بتشغيل سير عمل "shorts-v2" باستخدام قائمة المشاهد: [مطالبات المشهد].✓ تم النسخ
    → القطاعات في قائمة الانتظار؛ التقدم لكل مشهد
  2. غرزة ونشر
    نشر الفيديو النهائي.✓ تم النسخ
    → مسار الإخراج + نشر البيانات الوصفية

النتيجة: مقاطع فيديو قصيرة عبر الحوسبة المحلية، بدون رسوم سحابية لكل عرض.

المزالق
  • استنفاد ذاكرة وحدة معالجة الرسومات في المقاطع الأطول — تقليل الدقة أو الإطارات لكل مقطع؛ دفعة بالتتابع

التركيبات

اجمعها مع خوادم MCP أخرى لتحقيق نتائج x10

comfyui-mcp-server + comfy-pilot

قم بإقران MCP هذا مع محرر Claude-Code-in-ComfyUI للتأليف الكامل

قم ببناء سير العمل عبر comfy-pilot، وقم بتشغيله عبر خادم MCP هذا.✓ تم النسخ
comfyui-mcp-server + filesystem

تنظيم الأصول التي تم إنشاؤها ضمن مجلدات المشروع

بعد كل دفعة، انقل المخرجات إلى ./assets/<project>/ بأسماء ملفات مؤرخة.✓ تم النسخ
comfyui-mcp-server + mcp-image

استخدم صورة mcp لعشائر الجوزاء لمرة واحدة؛ ComfyUI لخطوط أنابيب SD/FLUX المحلية الخاصة بك

مشروع البطل عبر صورة mcp؛ تقديم مجموعة العلامة التجارية عبر سير عمل ComfyUI.✓ تم النسخ

الأدوات

ما يوفره هذا الـ MCP

الأداةالمدخلاتمتى تستدعيهاالتكلفة
generate_image prompt, settings معيار تحويل النص إلى صورة local compute only
generate_song / generate_video prompt, workflow توليد الصوت/الفيديو عبر مسارات عمل مخصصة local compute
regenerate reference job_id, tweaks تكرار النتيجة السابقة local compute
view_image asset_id إظهار الأصول المضمنة 0
get_queue_status / get_job / cancel_job job_id إدارة دورة الحياة 0
list_assets / get_asset_metadata filter تصفح المخرجات التي تم إنشاؤها 0
list_models / get_defaults / set_defaults optional model name تبديل نقاط التفتيش أو ضبط الإعدادات الافتراضية 0
list_workflows / run_workflow name + inputs تشغيل مسارات العمل المحفوظة 0 to start
publish_asset / get_publish_info asset_id وضع علامة على الأصل النهائي 0

التكلفة والحدود

تكلفة التشغيل

حصة API
محلي فقط - مرتبط بوحدة معالجة الرسومات (GPU) الخاصة بك
الرموز لكل استدعاء
نص موجه صغير؛ بايت الأصول كبيرة
التكلفة المالية
مجانًا - الكهرباء والأجهزة الخاصة بك
نصيحة
استخدم خطوات أقل/دقة أصغر للتكرار؛ حجز الإعدادات الكاملة للحارس.

الأمان

الصلاحيات والأسرار ونطاق الأثر

تخزين بيانات الاعتماد: لا توجد بيانات اعتماد لـ ComfyUI المحلي. إذا قمت بتوكيله إلى السحابة، أضف مصادقة على الوكيل.
نقل البيانات الخارجي: يعمل ComfyUI محليًا؛ حركة مرور الخادم هي 127.0.0.1 بشكل افتراضي. يتم سحب تنزيلات النماذج من HuggingFace / CivitAI وفقًا لسير عملك.

استكشاف الأخطاء

الأخطاء الشائعة وحلولها

تم رفض الاتصال 127.0.0.1:8188

ابدأ تشغيل ComfyUI أولاً؛ تأكيد تحميل واجهة المستخدم في المتصفح.

تحقق: curl localhost:8188/system_stats
فشل سير العمل مع فقدان العقدة المخصصة

افتح ComfyUI Manager وقم بتثبيت العقد المخصصة المطلوبة، ثم أعد المحاولة.

تحقق: Manager → Install Missing Custom Nodes
قائمة انتظار المهام ولكنها لا تكتمل أبدًا

تحقق من وحدة التحكم الخاصة بـ ComfyUI بحثًا عن خطأ CUDA OOM أو خطأ في تحميل النموذج.

تحقق: Inspect the ComfyUI terminal output

البدائل

ComfyUI MCP Server مقابل البدائل

البديلمتى تستخدمهاالمقايضة
comfy-pilotتريد محررًا يسمح لـ Claude بصياغة مسارات العمل داخل ComfyUI نفسهاليس خادم MCP خالصًا؛ يتطلب تثبيت عقدة ComfyUI
mcp-imageتريد إنشاء سحابة بدون إعداد عبر Geminiالدفع لكل صورة؛ مرونة أقل في سير العمل
everartتريد نماذج سحابية مدربة على الأسلوبمزود مختلف

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills