/ الدليل / الملعب / MCP Image
← كل الخوادم ↗ GitHub
● مجتمع shinpr 🔑 يتطلب مفتاحك

MCP Image

بواسطة shinpr · shinpr/mcp-image

قم بإنشاء الصور وتحريرها عبر Gemini (Nano Banana 2/Pro) - التحسين الفوري التلقائي، وإخراج 4K، وتحرير اللغة الطبيعية، وتناسق الأحرف.

يغلف mcp-image نماذج صور Gemini من Google (Nano Banana 2 / Nano Banana Pro) خلف أداة "إنشاء_صورة" واحدة. تغذية موجه بسيط؛ يقوم الخادم بإثرائه بإطار عمل Subject-Context-Style قبل استدعاء النموذج، ويختار مستوى الجودة (سريع/متوازن/جودة)، ويدعم تحرير الصور عبر اللغة الطبيعية، ويحافظ على اتساق الشخصية عبر الأجيال. إخراج يصل إلى 4K، ونسب العرض إلى الارتفاع من 1:1 إلى 21:9. يتطلب مفتاح Gemini API مجاني.

▶ شاهد العرض 📦 التثبيت 💡 حالات الاستخدام

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

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

عرض مباشر

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

mcp-image.replay ▶ جاهز
0/0

التثبيت

اختر العميل

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

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

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-image",
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ]
    }
  ]
}

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

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

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

claude mcp add mcp-image -- npx -y mcp-image

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

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

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

قم بإنشاء صورة رئيسية ثم كررها للصفحة المقصودة

👤 المصممين والمؤسسين والمسوقين ⏱ ~15 min beginner

متى تستخدمه: تريد صورة بطل جديدة ولا تريد التوفيق بين 5 علامات تبويب.

المتطلبات الأساسية
  • مفتاح الجوزاء API — https://aistudio.google.com/apikey
  • دليل الإخراج — mkdir -p ~/images/mcp
الخطوات
  1. توليد الإصدار 1
    قم بإنشاء صورة رئيسية: الحد الأدنى من مساحة العمل، ضوء الساعة الذهبية الدافئ، 16:9، مستوى الجودة، 2048 بكسل.✓ تم النسخ
    → تم حفظ الصورة في IMAGE_OUTPUT_DIR مع تكرار المطالبة الغنية
  2. تحرير في المكان
    قم بتحريره - أضف خطًا رفيعًا من الأشجار في الأفق، واحتفظ بكل شيء آخر.✓ تم النسخ
    → تم حفظ البديل؛ تم الحفاظ على التكوين
  3. جرب البديل
    نفس المشهد ولكن بألوان أكثر برودة، مع الحفاظ على تطابق الموضوع.✓ تم النسخ
    → يحافظ على اتساق الشخصية؛ تحول اللون

النتيجة: صورة بطل قابلة للشحن في دقائق، وليست رحلة ذهابًا وإيابًا بمقعد مدفوع الأجر عبر Midjourney.

المزالق
  • الإفراط في مطالبة المحسن — دع مُحسِّن نمط الموضوع والسياق يقوم بعمله؛ توقف عن التجاوز بخمسة أسطر من الصفات
اجمعها مع: filesystem

قم بإنتاج مجموعة من الرسوم التوضيحية المتوافقة مع العلامة التجارية

👤 مؤسسون ومصممون منفردون ليس لديهم مكتبة أصول العلامة التجارية ⏱ ~45 min intermediate

متى تستخدمه: أنت بحاجة إلى 6-12 صورة توضيحية تبدو وكأنها تنتمي معًا.

الخطوات
  1. تحديد ورقة الأنماط
    أنشئ مرجعًا للنمط: رسم توضيحي مسطح، ولوحة ألوان باستيل ناعمة، ومقالة صغيرة مكونة من حرفين.✓ تم النسخ
    → صورة البذور تلتقط النمط
  2. إنشاء الاختلافات
    باستخدام هذا الأسلوب، قم بإنشاء 6 رسوم توضيحية لأقسامنا: الإعداد، والفوترة، والفريق، وعمليات التكامل، والأمان، والتحليلات.✓ تم النسخ
    → 6 صور ذات نمط متناسق + أحرف

النتيجة: مجموعة رسوم توضيحية متماسكة دون الاستعانة برسام لمدة يوم واحد.

المزالق
  • الانجراف بين الصور — قم دائمًا بالإشارة إلى الصورة الأولية واستخدم "الاحتفاظ بالنمط من البذور"

تحرير صور المنتج باللغة الطبيعية

👤 مشغلي التجارة الإلكترونية، والعلامات التجارية الصغيرة ⏱ ~20 min beginner

متى تستخدمه: لديك صورة منتج خام وتريد معالجة البطل بدون Photoshop.

الخطوات
  1. تحميل / الرجوع إلى الصورة
    استخدم Product.jpg كقاعدة. إزالة الخلفية المزدحمة. الحفاظ على الظل. إضاءة الاستوديو.✓ تم النسخ
    → لقطة منتج نظيف بظل طبيعي
  2. أضف السياق
    نفس المنتج على سطح رخامي دافئ، من أعلى إلى أسفل.✓ تم النسخ
    → منتج متسق مع بيئة جديدة

النتيجة: صور جاهزة للكتالوج في دقائق.

اجمعها مع: filesystem

التركيبات

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

mcp-image + filesystem

إنشاء مكتبة صور وإدراجها ووضع علامات عليها وتنظيمها

قم بإنشاء مجموعة اليوم في ~/images/mcp/2026-04-21/; ثم قم بإدراج وإعادة التسمية حسب النص البديل.✓ تم النسخ
mcp-image + magic-ui-mcp

قم بإسقاط صور البطل التي تم إنشاؤها في منطقة هبوط Magic UI

قم بإنشاء صورة رئيسية، ثم قم بتوصيلها إلى مكون Magic UI البطل.✓ تم النسخ
mcp-image + comfyui-mcp-server

استخدم صورة mcp لأجيال لمرة واحدة؛ ComfyUI لخطوط الأنابيب

متغيرات سريعة عبر صورة mcp؛ سير عمل الإنتاج عبر ComfyUI.✓ تم النسخ

الأدوات

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

الأداةالمدخلاتمتى تستدعيهاالتكلفة
generate_image prompt: str, tier?: fast|balanced|quality, aspect?: '1:1'|'16:9'|..., base_image?: path, size?: '1K'|'2K'|'4K' أنشئ صورة جديدة أو قم بتحرير صورة موجودة باللغة الطبيعية 1 Gemini image call

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

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

حصة API
مقيد بحصة إنشاء الصور لخطة Gemini API الخاصة بك
الرموز لكل استدعاء
لا يكاد يذكر بالنسبة للنص؛ بايتات الصورة تهيمن
التكلفة المالية
الدفع لكل صورة عبر Gemini API؛ الطبقة المجانية المتاحة للتطوير
نصيحة
استخدم الطبقة = سريع للتكرار والطبقة = الجودة فقط للحارس النهائي.

الأمان

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

تخزين بيانات الاعتماد: GEMINI_API_KEY في البيئة فقط - لا تلتزم أبدًا. قم بالتدوير من Google AI Studio إذا تم تسريبه.
نقل البيانات الخارجي: تنتقل المطالبات والصور الأساسية الاختيارية إلى Google Gemini API. تعود وحدات البايت التي تم إنشاؤها ويتم حفظها محليًا.

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

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

401 / مفتاح API غير صالح

تأكد من أن GEMINI_API_KEY هو مفتاح API الأولي من AI Studio (وليس رمز OAuth)، وتم تمكين إنشاء الصور.

تحقق: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY
تم حفظ النواتج ولكنها فارغة

قد يكون IMAGE_OUTPUT_DIR غير قابل للكتابة أو مفقودًا. قم بإنشائه ثم أعد المحاولة.

تحقق: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe
الشخصية تنتقل بين الأجيال

قم دائمًا بتمرير نفس الصورة الأساسية وقم بتضمين "الحفاظ على الموضوع متطابقًا" في الموجه.

تحقق: Diff two generations visually

البدائل

MCP Image مقابل البدائل

البديلمتى تستخدمهاالمقايضة
everartلديك نماذج Everart مدربة على الأسلوبمزود مختلف، وتغطية بأسلوب مختلف
comfyui-mcp-serverأنت بحاجة إلى سير عمل SD/FLUX مخصص وتحكم كامل في خطوط الأنابيبإعداد أثقل بكثير
higgsfield-ai-prompt-skillتريد مساعدة هندسية سريعة لمزود آخرالمطالبات فقط - لا يوجد استنتاج

المزيد

الموارد

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

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

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