للمطوّرين
خادم MCP لـ Nano Banana Pro
دع مساعد الذكاء الاصطناعي ينشئ الصور ومقاطع الفيديو نيابةً عنك. أضف عنوان خادم واحدًا إلى عميل يدعم Model Context Protocol، ثم سجّل الدخول إلى حسابك في المتصفح، وصف ما تحتاج إليه بلغتك العادية.
آلية العمل
أضف عنوان الخادم
الصق العنوان أدناه في العميل عبر أمره أو ملف إعداداته أو حقل الموصّل المخصّص.
عنوان خادم MCP
https://preview.bananapro.site/api/mcpسجّل الدخول وامنح الإذن
يفتح العميل نافذة في المتصفح. سجّل الدخول إلى حسابك في Nano Banana Pro ثم اضغط «سماح». لا حاجة إلى كتابة مفتاح API.
صف ما تحتاج إليه
اطلب صورة أو مقطع فيديو في المحادثة. يختار المساعد أداة ويبدأ المهمة ويعيد روابط النتيجة.
الإعداد حسب العميل
اختر العميل الذي تستخدمه. قد تختلف أسماء القوائم قليلًا بين الإصدارات.
Claude Code
- 1نفّذ الأمر أدناه في الطرفية لإضافة الخادم.
- 2في Claude Code افتح /mcp واختر nanobanana وأكمل تسجيل الدخول في المتصفح.
claude mcp add --transport http nanobanana https://preview.bananapro.site/api/mcpCodex
- 1نفّذ الأمر الأول في الطرفية لإضافة الخادم.
- 2نفّذ الأمر الثاني. ستُفتح نافذة في المتصفح.
- 3سجّل الدخول إلى حسابك واضغط «سماح».
codex mcp add nanobanana --url https://preview.bananapro.site/api/mcpcodex mcp login nanobananaCursor وعملاء JSON
- 1أضف ما يلي إلى ملف إعدادات MCP الخاص بالعميل، مثل mcp.json في Cursor.
- 2أعد تشغيل العميل عند الحاجة. عند أول استخدام تُفتح نافذة في المتصفح: سجّل الدخول واضغط «سماح».
{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp"
}
}
}موصّل مخصّص
- 1افتح إعدادات العميل وابحث عن حقل الموصّل المخصّص أو خادم MCP البعيد.
- 2الصق عنوان الخادم الظاهر أدناه واحفظ.
- 3اختر «اتصال» وسجّل الدخول إلى حسابك ثم اضغط «سماح».
https://preview.bananapro.site/api/mcpمفتاح API
- 1استخدم هذه الطريقة فقط مع العملاء الذين لا يستطيعون فتح المتصفح.
- 2أنشئ مفتاحًا في صفحة مفاتيح API. أرسله في الترويسة الظاهرة في الحقل الأول، أو أضفه ضمن headers في إعداد JSON كما في الحقل الثاني.
- 3احفظ المفتاح في إعدادات بيانات الاعتماد الخاصة بالعميل ولا تشاركه مع أحد.
Authorization: Bearer YOUR_API_KEY{
"mcpServers": {
"nanobanana": {
"url": "https://preview.bananapro.site/api/mcp",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}ما الذي يستطيع المساعد فعله
يوفّر الخادم ست أدوات. أربع منها تقرأ المعلومات فقط ولا تستهلك رصيدًا، واثنتان تبدآن عملية إنشاء وتستهلكان رصيدًا.
| الأداة | وظيفتها | تستهلك رصيدًا |
|---|---|---|
| list_models | تعرض النماذج المتاحة لحسابكم للصور والفيديو، وأنواع الطلبات التي يقبلها كل نموذج. | لا |
| get_balance | تعرض الرصيد المتبقي في الحساب. | لا |
| generate_image | تبدأ إنشاء صورة أو تعديل صورة انطلاقًا من وصف نصي وصور مرجعية اختيارية. | نعم |
| generate_video | تبدأ إنشاء فيديو انطلاقًا من وصف نصي أو صور أو وسائط مرجعية أخرى. | نعم |
| get_task | تتحقق من حالة عملية إنشاء وتعيد روابط النتيجة عند اكتمالها. | لا |
| list_tasks | تعرض أحدث عمليات الإنشاء، وهي مفيدة عند فقدان معرّف المهمة. | لا |
أداة سطر الأوامر
يتيح الأمر nanobanana إنشاء الصور ومقاطع الفيديو من الطرفية ومن النصوص البرمجية ومن تطبيقات الذكاء الاصطناعي القادرة على تنفيذ الأوامر على حاسوبك.
يتطلب Node.js 22 أو أحدث على macOS أو Linux.
ثبّت CLI
ثبّت الحزمة @nanobanana-pro/cli باستخدام npm.
npm install -g @nanobanana-pro/cliسجّل الدخول
نفّذ الأمر ثم سجّل الدخول إلى حسابك في نافذة المتصفح واضغط «سماح».
nanobanana auth loginتحقّق من الحساب والنماذج
يعرض هذا الأمر رصيدك من الأرصدة. ويعرض الأمر nanobanana models النماذج المتاحة.
nanobanana accountأنشئ
احفظ طلبًا يتضمن النموذج والموجّه في request.json ثم نفّذ الأمر. يُبقي الخيار --wait الأمر قيد التشغيل حتى تنتهي المهمة.
nanobanana create --input request.json --waitنزّل النتيجة
استبدل TASK_ID بمعرّف المهمة الذي أعاده الأمر السابق.
nanobanana download TASK_ID --output result.png
شاهده أثناء العمل
اطلب صورة بجملة واحدة. يكتب تطبيق الذكاء الاصطناعي الطلب وينشئ الصورة ويحفظ الملف.
$ nanobanana create --input request.json --wait
Task TASK_ID submitted; waiting for the result…
{ "status": "completed" }
$ nanobanana download TASK_ID --output result.png
{ "files": ["result.png"] }
النماذج
يستطيع المساعد استخدام نماذج الصور والفيديو التي يمكن لحسابك استخدامها في الموقع وفي API.
- اطلب من المساعد استدعاء list_models للحصول على قائمة النماذج الحالية وأنواع الطلبات التي يقبلها كل نموذج.
- يقدّم كل نموذج الخيارات نفسها المتاحة في الموقع. وأي إعداد لا يدعمه النموذج يُرفض مع توضيح.
- يجب أن تكون الصور ومقاطع الفيديو المرجعية روابط https عامة. لا يمكن رفع الملفات عبر MCP.
الرصيد والفوترة
- تسجيل الدخول والأدوات المجانية (list_models وget_balance وget_task وlist_tasks) لا تكلّف شيئًا.
- يستهلك generate_image وgenerate_video الرصيد نفسه المستهلك في الموقع وفي API، ويُخصم من رصيد حسابك.
- تُسترد تكلفة المهمة التي تفشل تلقائيًا.
- اشتراكك في مساعد الذكاء الاصطناعي نفسه منفصل، ويُحاسَب عليه لدى ذلك المساعد.
أمثلة على الطلبات
بعد الاتصال، أرسل أحد هذه الطلبات إلى مساعدك.
- ما نماذج الصور والفيديو التي يمكنني استخدامها؟ اعرضها في قائمة قصيرة.
- أنشئ صورة منتج بنسبة 16:9 لكوب خزفي على طاولة خشبية.
- حوّل صورة المنظر الطبيعي هذه إلى فيديو مدته خمس ثوانٍ: https://example.com/photo.jpg
- تحقّق من حالة أحدث مهمة لديّ وأرسل لي رابط النتيجة.
الأسئلة الشائعة
هل أحتاج إلى مفتاح API؟
لا، مع العملاء الذين يستطيعون فتح المتصفح؛ يكفي تسجيل الدخول والضغط على «سماح». لا يلزم المفتاح إلا مع العملاء الذين لا يستطيعون ذلك، كما هو موضح في قسم «مفتاح API».
أين أرى الاتصال أو أزيله؟
افتح صفحة مفاتيح API. يظهر كل اتصال هناك باسم عميله، ويؤدي حذفه إلى إنهاء وصول ذلك العميل.
كم تكلّف عملية الإنشاء؟
الرصيد نفسه المستهلك في الموقع وفي API. وتُسترد تكلفة المهمة التي تفشل تلقائيًا.
هل يمكنني استخدام صوري أو مقاطعي كمراجع؟
نعم، بشرط أن تكون روابط https عامة. لا يوجد رفع للملفات، لذا ضع الملف في مكان يمكن الوصول إليه وأرسل عنوانه.
الاتصال يعمل لكن الأدوات لا تظهر. ماذا أفعل؟
تأكد من اكتمال تسجيل الدخول ومن أن العميل يعرض الخادم على أنه متصل. ثم ابدأ محادثة جديدة، لأن بعض العملاء لا يحمّلون الأدوات إلا عند بداية المحادثة.
أين أجد النتائج؟
يعيد المساعد روابط النتيجة في المحادثة. ويمكن سرد المهام السابقة مرة أخرى باستخدام list_tasks.
هل تفضّلون استدعاء API بأنفسكم؟
بُني خادم MCP على API العامة. ويسرد التوثيق كل نقطة وصول ومعامل ونموذج.