Skip to main content

​
Zihinsel model

ComfyUI MCP, çalışan bir ComfyUI örneği üzerinde ince, iyi tanımlanmış bir katmandır. Araçların çoğu o örnekle HTTP/WebSocket API’si üzerinden konuşur; bu yüzden ComfyUI yerel, uzak (--comfyui-url) ya da Comfy Cloud (COMFYUI_API_KEY) olsun aynı şekilde çalışırlar.
1

Üretim ve iş akışları → ComfyUI HTTP API

generate_image, enqueue_workflow, kuyruk/geçmiş/sistem-istatistikleri ve iş akışı oluşturma araçları ComfyUI’nin /prompt, /queue, /history, /object_info vb. uç noktalarını çağırır. Kuyruğa alma ateşle-unut: hemen bir prompt_id alırsınız ve sonuçlar bir tamamlanma bildirimiyle gelir. Bulut kipinde alternatif bir cloud-client aynı işlemleri X-API-Key üzerinden cloud.comfy.org’a dağıtır.
2

Özel düğümler ve modeller → ComfyUI-Manager (HTTP), alt süreç yedeğiyle

Düğüm kur/güncelle/anlık görüntü/bisect ve iş akışı bağımlılık kurulumları ComfyUI-Manager HTTP API’sini yeğler (böylece uzak örneklere karşı da çalışırlar); API işi yapamadığında yerel bir kurulumda cm-cli / git / pip/uv yedeğine düşer.
3

Kurulum ve dosya sistemi işlemleri → yalnızca yerel

ComfyUI kurmak, çekirdeği güncellemek, model dosyalarını silmek, sunucu günlüklerini okumak ve çıktı dizinini listelemek yerel dosya sisteminde iş görür. Bilinen bir COMFYUI_PATH gerektirirler ve uzak ya da bulut kipinde açık bir hata döndürürler.
4

WebSocket → yerel + uzak, bulut değil

İş tamamlanma bildirimleri varsa ComfyUI’nin WebSocket’ine tutunur. Comfy Cloud’un WebSocket’i yoktur — iş izleyici mevcut HTTP yoklama yoluna düşer.
Parmak kuralı: bağlı sunucuyu okuyan ya da çalıştıran her şey her kipte çalışır; yazılım kuran ya da diskteki dosyalara dokunan her şey yerel bir kurulum ister. Tam özellik denklik tablosu Yapılandırma → Dağıtım kipleri sayfasındadır.

​
Kendini onarma: kuyruk/işleme gözcüsü

Sıkışmış yüksek çözünürlüklü bir örnekleyici adımı, ajanın göremediği ya da öldüremediği bir zombi işlemenin arkasına iş yığmasına izin verirdi. Üç elden geldiğince koruma o boşluğu kapatır; böylece ajan sıkışmış bir işlemenin arkasına körlemesine yeniden kuyruk eklemeyi bırakır:
  • Geri basınç — panel_run, bir işleme zaten çalışıyorken sonucuna bir QUEUE WARNING ekler; böylece ajan onun arkasına yığılmaz.
  • Takılma saptama — ComfyUI’ye edilgen bir WebSocket çalışan istemi / düğümü / ilerlemeyi izler; eşiğin ötesinde ilerlemeyi bırakan bir adım (COMFYUI_MCP_STALL_S, varsayılan 180 sn) ajanın sonraki turuna tek satırlık bir STALL/BACKLOG notu ekler.
  • Yükselen iptal — queue (action:“cancel”) keser, işin gerçekten durduğunu doğrular (COMFYUI_MCP_INTERRUPT_S içinde, varsayılan 30 sn), sonra /free’ye yükselir ve hâlâ ölmüyorsa işlemeyi WEDGED bildirir (restart_comfyui önererek); clear_pending bekleyen tüm işleri aynı çağrıda düşürür.
Hepsi başarısızlığa dayanıklıdır: gözcü WebSocket’i hiç açılmazsa hiçbir şey değişmez. Ajan ayrıca get_image (action:"analyze_color") ile bir görselin renkleri hakkında bir görüş gidiş-dönüşü olmadan akıl yürütebilir (baskın palet, ortalama + parlaklık istatistikleri, karşıtlık denetimleri).

​
Araç kategorileri

Görsel üretimi

İş akışı çalıştırma

İş akışı oluşturma

İş akışı kitaplığı

Varlıklar ve görseller

Modeller

Özel düğümler

API düğümleri

Kurulum ve ortam

Süreç denetimi

Varsayılanlar, istatistikler ve beceriler

Araç referansı canlı MCP araç şemalarından üretilir (npm run docs:gen); böylece koddan asla sapmaz.