الانتقال إلى المحتوى الرئيسي

Documentation Index

Fetch the complete documentation index at: https://docs.acedata.cloud/llms.txt

Use this file to discover all available pages before exploring further.

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:
  1. سجل أو قم بتسجيل الدخول إلى منصة AceData Cloud
  2. انتقل إلى صفحة Nano Banana Images API
  3. انقر على “Acquire” للحصول على رمز API (تمنحك أول طلبات مجانية)

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

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

pip install mcp-nanobanana-pro

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

git clone https://github.com/AceDataCloud/MCPNanoBanana.git
cd MCPNanoBanana
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 لتوليد صورة شخصية عالية الجودة”

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