دليل تكامل Nano Banana MCP

MCP (نموذج بروتوكول السياق) هو بروتوكول سياق النموذج الذي أطلقته شركة Anthropic، والذي يسمح لنماذج الذكاء الاصطناعي (مثل Claude وGPT وغيرها) باستدعاء أدوات خارجية من خلال واجهات موحدة. من خلال خادم Nano Banana MCP المقدم من AceData Cloud، يمكنك مباشرةً إنشاء وتحرير صور الذكاء الاصطناعي في عملاء الذكاء الاصطناعي مثل Claude Desktop وVS Code وCursor.

نظرة عامة على الوظائف

يوفر خادم Nano Banana MCP الوظائف الأساسية التالية:

توليد الصور — توليد صور عالية الجودة من خلال نصوص توجيهية
تحرير الصور — تعديل الصور الموجودة أو دمج عدة صور
تجربة الملابس الافتراضية — ارتداء الملابس على صور الأشخاص
زرع المنتجات — وضع المنتجات في مشاهد حقيقية
دعم نماذج متعددة — دعم نماذج nano-banana وnano-banana-2 وnano-banana-pro
استعلام المهام — مراقبة تقدم التوليد والحصول على النتائج

التحضيرات المسبقة

قبل الاستخدام، تحتاج إلى الحصول على رمز API من AceData Cloud:

سجل أو قم بتسجيل الدخول إلى منصة AceData Cloud
انتقل إلى صفحة Nano Banana Images API
انقر على “Acquire” للحصول على رمز API (تمنحك أول طلبات مجانية)

التثبيت والتكوين

الطريقة الأولى: تثبيت pip (موصى به)

pip install mcp-nanobanana-pro

الطريقة الثانية: تثبيت من المصدر

git clone https://github.com/AceDataCloud/NanoBananaMCP.git
cd NanoBananaMCP
pip install -e .

بعد الانتهاء من التثبيت، يمكنك استخدام الأمر mcp-nanobanana-pro لبدء الخدمة.

الاستخدام في Claude Desktop

قم بتحرير ملف تكوين Claude Desktop:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

أضف التكوين التالي:

{
  "mcpServers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

إذا كنت تستخدم uvx (لا حاجة لتثبيت الحزمة مسبقًا):

{
  "mcpServers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

بعد حفظ التكوين، أعد تشغيل Claude Desktop، وستتمكن من استخدام أدوات Nano Banana في المحادثة.

الاستخدام في VS Code / Cursor

قم بإنشاء ملف .vscode/mcp.json في جذر المشروع:

{
  "servers": {
    "nanobanana": {
      "command": "mcp-nanobanana-pro",
      "env": {
        "ACEDATACLOUD_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

أو استخدم uvx:

{
  "servers": {
    "nanobanana": {
      "command": "uvx",
      "args": ["mcp-nanobanana-pro"],
      "env": {
        "ACEDATACLOUD_API_TOKEN": "رمز API الخاص بك"
      }
    }
  }
}

قائمة الأدوات المتاحة

اسم الأداة	الوصف
`nanobanana_generate_image`	توليد صورة من خلال نصوص توجيهية
`nanobanana_edit_image`	تحرير أو دمج الصور الموجودة
`nanobanana_get_task`	استعلام عن حالة مهمة واحدة
`nanobanana_get_tasks_batch`	استعلام عن حالة المهام بشكل جماعي

أمثلة على الاستخدام

بعد الانتهاء من التكوين، يمكنك استدعاء هذه الوظائف مباشرةً بلغة طبيعية في عميل الذكاء الاصطناعي، مثل:

“ساعدني في توليد صورة بأسلوب الألوان المائية”
“قم بإضافة هذه الملابس إلى هذه الصورة”
“ضع هذا المنتج في مشهد مقهى”
“استخدم نموذج nano-banana-pro لتوليد صورة شخصية عالية الجودة”

مزيد من المعلومات

مستودع GitHub: AceDataCloud/NanoBananaMCP
حزمة PyPI: mcp-nanobanana-pro
وثائق API: Nano Banana API

​نظرة عامة على الوظائف

​التحضيرات المسبقة

​التثبيت والتكوين

​الطريقة الأولى: تثبيت pip (موصى به)

​الطريقة الثانية: تثبيت من المصدر

​الاستخدام في Claude Desktop

​الاستخدام في VS Code / Cursor

​قائمة الأدوات المتاحة

​أمثلة على الاستخدام

​مزيد من المعلومات