> ## Documentation Index
> Fetch the complete documentation index at: https://comfyui-mcp.artokun.io/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# إضافة Claude Code

> comfyui-mcp إضافة كاملة لـ Claude Code: 39 مهارة ذكاء اصطناعي، و11 أمرًا مختصرًا، و4 وكلاء مستقلين، و3 خطافات فوق 37 أداة MCP — معرفة خبيرة بـ ComfyUI تنمو مع كل إصدار.

`comfyui-mcp` ليس مجرّد خادم MCP — بل يُشحن **إضافة Claude Code** كاملة.
تثبيت الإضافة يمنح Claude معرفة خبيرة خاصة بالنماذج عن ComfyUI فيختار العيّنة
الصحيحة وCFG والدقة وملفات النماذج دون تجريب وخطأ.

```bash theme={null}
# In Claude Code
/plugin marketplace add artokun/comfyui-mcp
/plugin install comfy
```

## 39 مهارة ذكاء اصطناعي — وما زالت تنمو

المهارات وثائق معرفة منتقاة يحمّلها Claude عند الحاجة. وتحصل كل عائلة نماذج
على معاملات التوليد ومخططات العقد وروابط تنزيل منتقاة وإرشاد لأنماط الفشل:

| المهارة                            | ما الذي يتعلّمه Claude                                                                                                                                                                                                                           |
| ---------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `flux-txt2img`                     | Flux.1 Dev/Schnell + Flux 2 Klein — مطبات BF16 مقابل FP8، وتوصيل CLIP المزدوج، واختيار VAE                                                                                                                                                       |
| `wan-t2v-video` / `wan-flf-video`  | مسارات WAN 2.x من النص إلى الفيديو ومن الإطار الأول-الأخير                                                                                                                                                                                       |
| `wan-scail-replacement`            | استبدال الشخصيات داخل الفيديو بـ SCAIL-2 — قاعدة الإطار المرجعي←المقياس، ومطبات الضبط والتركيب                                                                                                                                                   |
| `ltxv2-video`                      | LTX-2.3 (وLTX-2 19B) — UNet بصيغة GGUF، والنموذج المقطَّر، وملفات LoRA للتحكّم بالكاميرا، والرفع على مرحلتين، وإصلاح kornia                                                                                                                      |
| `qwen-txt2img` / `qwen-image-edit` | توليد Qwen-Image والتحرير القائم على التعليمات                                                                                                                                                                                                   |
| `z-image-txt2img`                  | مسارات Z-Image Turbo                                                                                                                                                                                                                             |
| `ideogram-ultra`                   | Ideogram 4 — تحويل النص إلى صورة بأوزان مفتوحة، والموجّهات المناطقية، والشعارات / الملصقات / النص المقروء                                                                                                                                        |
| `ernie-image`                      | ERNIE-Image — تحويل نص إلى صورة سريع، وعرض نص متعدّد اللغات دقيق، يعمل بأقل من 8 غيغابايت من ذاكرة VRAM                                                                                                                                          |
| `anima-base`                       | ANIMA 1.0 — نموذج أنمي/رسوم بنحو 2B، ووسوم Danbooru + لغة طبيعية، وطلاء أنمي، بأقل من 6 غيغابايت من ذاكرة VRAM                                                                                                                                   |
| `anima-lora-trainer`               | درّب ملفات LoRA أنمي مخصّصة — مدرّب kohya `sd-scripts` عبر Gradio، بأقل من 6 غيغابايت من ذاكرة VRAM                                                                                                                                              |
| `ai-toolkit-trainer`               | درّب ملفات LoRA مخصّصة لـ WAN 2.2 + Z-Image (أشخاص / أنماط / حركة) — ostris AI-Toolkit، محليًا أو على RunPod                                                                                                                                     |
| `installer-packs`                  | استخدم وابنِ واشتق حزم تثبيت بأمر واحد — وادعُ المستخدمين إلى المساهمة بحزم جديدة في المصدر                                                                                                                                                      |
| `panel-node-pack-sync`             | أبقِ حزمة عقد اللوحة الجانبية متزامنة مع المنسّق بعد التحديث — كشف عدم تطابق الإصدار، ودبوس إصدار يُحذَّر منه بدل تجاوزه، ومزامنة تُعاد قراءتها من القرص                                                                                         |
| `model-compatibility`              | أي أزواج VAE/CLIP/مشفّر النص تتوافق مع أي معمارية — المصدر رقم 1 لمسارات العمل المعطوبة                                                                                                                                                          |
| `model-registry`                   | روابط تنزيل منتقاة + أدلة هدف لكل نموذج تشير إليه المهارات — تنمو مع كل إصدار                                                                                                                                                                    |
| `civitai`                          | اكتشاف Civitai الأصلي → حلقة تنزيل/توصيل/توليد محلية عبر `download_model` المدمج `action:"search_civitai"` (بلا مفتاح، بلا خادم إضافي)؛ أمّا [Civitai MCP](https://mcp.civitai.com/mcp) الرسمي فإضافة مجتمعية اختيارية، غير مضمَّنة              |
| `comfyui-core`                     | دلالات قائمة الانتظار والسجل والواجهة البرمجية                                                                                                                                                                                                   |
| `comfyui-node-registry`            | تأليف حزم العقد المخصّصة ونشرها في Comfy Registry                                                                                                                                                                                                |
| `comfyui-frontend-extensions`      | تأليف امتدادات الواجهة الأمامية v1/v2 (تبويبات الشريط الجانبي، وعناصر التحكّم)                                                                                                                                                                   |
| `rgthree`                          | إعداد rgthree-comfy — مفاتيح مجموعات Fast Groups Bypasser/Muter (عقد واجهة أمامية فقط غائبة عن `/object_info`، تُضبَط عبر خصائص العقدة لا عناصر التحكّم)، وتكديس Power Lora Loader، وحافلات Context                                              |
| `director`                         | إخراج مشاهد متعدّدة اللقطات لأنابيب الفيديو                                                                                                                                                                                                      |
| `prompt-engineering`               | صياغة موجّهات خاصة بالمعمارية (لغة طبيعية مقابل وسوم)                                                                                                                                                                                            |
| `troubleshooting`                  | نفاد الذاكرة، والعقد الناقصة، وانحراف الإصدارات — أشجار تشخيص                                                                                                                                                                                    |
| `comfyui-launch-flags`             | مصفوفة رايات التشغيل لذاكرة VRAM/الانتباه/التخزين المؤقّت/الأداء — `--reserve-vram`، و`--novram`+`--cache-none`، و`--use-sage-attention` مقابل `--use-pytorch-cross-attention` (Z-Image)، إضافةً إلى ملاحظات مكدّس التسريع لـ Blackwell/RTX 5000 |

تهبط مهارات جديدة مع كل إصدار — مولَّدة من حزم السجل الشائعة عبر أداة
`list_packs` المدمجة (`action: "generate_skill"`)، ثم ينتقيها إنسان.

**جرّب المعرفة قبل توصيل أي شيء** — كل مهارة ملف markdown عادي، مفيد وحده.
وأوسعها تطبيقًا هي
[`prompt-engineering`](https://github.com/artokun/comfyui-mcp/blob/main/plugin/skills/prompt-engineering/SKILL.md)
— حدّ CLIP البالغ 77 رمزًا وتقطيع `BREAK`، وصياغة الأوزان، والاستراتيجية حسب
المعمارية (لماذا يريد Flux لغة طبيعية بلا موجّه سلبي بينما يريد SD1.5 وسومًا).
اقرأها في المتصفح، أو الصقها في سياق أي وكيل كموجّه نظام — بلا حاجة إلى
ComfyUI أو MCP أو تثبيت. وعندما تصل الإضافة كاملة، تحمّل الوكلاء الملفات نفسها
تلقائيًا (`list_packs` مع `action: "skill_read"`).

### البحث في Civitai — مدمج

يبحث `download_model` `action:"search_civitai"` في Civitai أصليًا (واجهة REST
عامة، بلا مفتاح، بلا خادم إضافي): كلمة مفتاحية + عوامل `types` + `base_models`
(«ملف LoRA لـ **Flux**»)، وآمن للعرض افتراضيًا، وكل نتيجة تُرجع
`model_version_id` الذي يأخذه `action:"download_civitai"` مباشرة — إضافةً إلى
**كلمات تشغيل** النموذج للموجّه. ولأنه أداة من الدرجة الأولى يعمل على **كل
خلفية**، بما فيها النماذج المحلية الصغيرة خلف الموجّه المضغوط. وتعلّم مهارة
`civitai` تسليم الاكتشاف → التنزيل → التوليد كاملًا.

**مفتاح API اختياري.** البحث لا يحتاج إلى أي مفتاح. ويفتح `CIVITAI_API_TOKEN`
التنزيلات المحجوبة/ذات الوصول المبكر ونتائج البحث المحجوبة — متغيّر واحد يشغّل
البحث والتنزيل معًا.

**اختياري: Civitai MCP الرسمي.** لسطح المجتمع وراء البحث→التثبيت (تصفّح صور
الأمثلة + معاملات توليدها، والنشر، والمجموعات)، اقرن
[الخادم البعيد الرسمي](https://mcp.civitai.com/mcp) لدى Civitai
— لم يعد يُضمَّن تلقائيًا، أضِفه مرة واحدة:

```bash theme={null}
claude mcp add --transport http civitai https://mcp.civitai.com/mcp \
  --header "Authorization: Bearer YOUR_CIVITAI_API_KEY"
```

## 11 أمرًا مختصرًا

`/comfy:gen` (ولّد من موجّه)، `/comfy:debug` (شخّص سير عمل فاشل)،
`/comfy:install` (ثبّت حزم العقد)، `/comfy:viz` (سير عمل → Mermaid)،
`/comfy:batch`، `/comfy:compare`، `/comfy:convert`، `/comfy:gallery`،
`/comfy:recipe`، `/comfy:director`، `/comfy:node-skill`.

## 4 وكلاء مستقلين

* **comfy-explorer** — يغوص في مصدر حزمة عقد لتوثيقها
* **comfy-researcher** — بيان مشكلة → توصيات حزم مرتَّبة
* **comfy-debugger** — يتتبّع جذور مسارات العمل الفاشلة من السجل + اللوجات
* **comfy-optimizer** — ضبط ذاكرة VRAM والسرعة لوحدة GPU معيّنة

## اللوحة الجانبية — بلا مفاتيح API

<Note>
  تُشحن اللوحة الجانبية كحزمة مستقلة، **على Comfy Registry وفي
  ComfyUI-Manager باسم `comfyui-agent-panel`** — ابحث عنها هناك واختر
  **Latest**، لا Nightly. الدليل الكامل: [اللوحة الجانبية](/docs/docs/ar/panel).
</Note>

يشغّل الشريط الجانبي [comfyui-mcp-panel](https://github.com/artokun/comfyui-mcp-panel)
وكيلًا مستقلًا على **اشتراك Claude** لديك (بلا فوترة API لكل رمز). ثبّت الحزمة،
وافتح تبويب الوكيل، وانقر **اتصال** — فيبدأ
[منسّق اللوحة](/docs/docs/ar/configuration) عند الطلب؛ اطلب منه صورة أو سير عمل أو
تعديلًا فيعمل على ComfyUI لديك.

## الخطافات

ثلاثة خطافات تُبقي جلسات التوليد محكمة: **فحوصات VRAM المسبقة** قبل إدراج سير
عمل في قائمة الانتظار، و**إشعارات اكتمال المهام**، و**تحذيرات الحفظ** قبل
العمليات المدمِّرة.