Nano Banana MCP Server برائے Claude، Cursor اور Gemini CLI

ایک ریموٹ Model Context Protocol سرور جو BananaBanana کے مکمل جنریشن اسٹیک کو ایجنٹ ٹولز کے طور بر پیش کرتا ہے: گوگل کی Nano Banana 2 Lite / 2 / 2.1 / Pro تصاویر ($0.03 سے)، Veo 3.1 / Fast / Lite ویڈیو اور آواز کے ساتھ Gemini Omni Flash ($0.09–1.00)، Wan 3.0۔ آپ کا ایجنٹ لائیو قیمتیں دیکھتا ہے، مہنگے رینڈرز سے پہلے اخراجات کی تصدیق کرتا ہے، اور ہر جنریشن ویب سائٹ کی طرح اسی ہسٹری اور بیلنس میں شامل ہوتی ہے۔

• اینڈ پوائنٹ: https://bananabanana.pro/api/mcp (Streamable HTTP)
• توثیق: OAuth 2.1 سے سائن اِن (claude.ai اور دیگر کنیکٹر والے کلائنٹس) یا اپنے پروفائل سے Bearer API کلید
• ریٹ لمیٹ: 20 ٹول کالز فی منٹ فی کی (key)؛ اختیاری طور پر فی کی روزانہ خرچ کی حد
• کوئی MCP کلائنٹ نہیں ہے؟ یہی اینڈ پوائنٹ HTTPS پر ایک سادہ JSON-RPC ہے — بغیر کسی SDK کے اسے curl، Python یا TypeScript سے کال کریں
• ناکام یا فلٹر ہونے والی جنریشنز کے پیسے خودکار طور پر ریفنڈ کر دیے جاتے ہیں
• دستاویزات (docs) اور server.json کھولیں، اور bananabanana-mcp GitHub ریپوزٹری میں موجود کلائنٹ کی مثالوں کو کاپی پیسٹ کریں

1۔ ایک اکاؤنٹ بنائیں اور بیلنس ٹاپ اپ کریں۔ 2۔ Profile → MCP API Keys میں ایک کی بنائیں (جو صرف ایک بار دکھائی جاتی ہے)۔ 3۔ سرور کو اپنے کلائنٹ میں شامل کریں:

claude.ai، Claude Desktop، موبائل (OAuth — کچھ کاپی کرنے کی ضرورت نہیں)

Settings ← Connectors ← Add custom connector میں https://bananabanana.pro/api/mcp پیسٹ کریں اور Connect دبائیں۔ Claude خود رجسٹر ہو جاتا ہے، آپ BananaBanana کی اسکرین پر رسائی منظور کرتے ہیں، اور جنریشنز اُسی اکاؤنٹ سے کٹتی ہیں جس سے آپ نے سائن اِن کیا۔

Settings → Connectors → Add custom connector
URL: https://bananabanana.pro/api/mcp
→ Add → Connect → approve access on bananabanana.pro

یہی طریقہ ہر اُس کلائنٹ میں کام کرتا ہے جو MCP اجازت نامہ سپورٹ کرتا ہے — MCP Inspector، ChatGPT اور Grok کے ویب کنیکٹرز، Claude Code۔ منسلک ایپس آپ کے پروفائل میں نظر آتی ہیں اور وہیں سے کسی بھی وقت منقطع کی جا سکتی ہیں۔

Claude Code

# with an API key
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

# or with OAuth — no key, sign in in the browser
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp
# then run /mcp inside Claude Code and pick "Authenticate"

Claude Desktop

اسے claude_desktop_config.json (Settings → Developer → Edit Config) میں شامل کریں؛ mcp-remote برج کے لیے Node.js درکار ہے:

{
  "mcpServers": {
    "bananabanana": {
      "command": "npx",
      "args": [
        "-y", "mcp-remote", "https://bananabanana.pro/api/mcp",
        "--header", "Authorization: Bearer bb_live_YOUR_KEY"
      ]
    }
  }
}

Cursor

پروجیکٹ میں ~/.cursor/mcp.json (گلوبل) یا .cursor/mcp.json میں شامل کریں؛ کی (key) کو فائل سے باہر رکھنے کے لیے، اصل ویلیو کے بجائے ${env:BB_API_KEY} استعمال کریں:

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      }
    }
  }
}

Cursor کا مکمل گائیڈ، بشمول باریکیاں اور لائیو کی (live-key) ڈیمو: Cursor میں تصاویر تیار کریں۔

VS Code / GitHub Copilot

ورک اسپیس میں .vscode/mcp.json (یا اپنے صارف کی settings.json) میں شامل کریں؛ VS Code ایک بار کی (key) مانگے گا اور اسے انکرپٹ کر کے محفوظ کر لے گا:

{
  "servers": {
    "bananabanana": {
      "type": "http",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:bb-api-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "bb-api-key",
      "description": "BananaBanana API key (bb_live_…)",
      "password": true
    }
  ]
}

VS Code / Copilot کا مکمل گائیڈ، بشمول باریکیاں اور لائیو کی ڈیمو: VS Code میں تصاویر تیار کریں: Copilot MCP سیٹ اپ گائیڈ۔

Windsurf

اسے ~/.codeium/windsurf/mcp_config.json میں شامل کریں:

{
  "mcpServers": {
    "bananabanana": {
      "serverUrl": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      }
    }
  }
}

Windsurf MCP Setup: Generate Images in Cascade

Cline

{
  "mcpServers": {
    "bananabanana": {
      "type": "streamableHttp",
      "url": "https://bananabanana.pro/api/mcp",
      "headers": {
        "Authorization": "Bearer bb_live_YOUR_KEY"
      },
      "disabled": false,
      "autoApprove": ["list_models", "get_account", "get_result"]
    }
  }
}

Cline MCP Server: Generate Images From Your Editor

کوئی بھی دوسرا MCP کلائنٹ (خام JSON-RPC)

POST https://bananabanana.pro/api/mcp
Authorization: Bearer bb_live_YOUR_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

ping اور ڈسکوری فہرستوں (tools/list، prompts/list، resources/list) کے سوا ہر طریقے کے لیے اسناد درکار ہیں — initialize بھی شامل ہے: بغیر تصدیق کے ہینڈ شیک WWW-Authenticate چیلنج کے ساتھ 401 واپس کرتا ہے۔ یہ عدم توازن جان بوجھ کر ہے، کوئی خرابی نہیں: کنیکٹر کلائنٹ اسی چیلنج سے جانتا ہے کہ یہ سرور OAuth استعمال کرتا ہے۔ کلید کے بغیر ٹول کیٹلاگ پڑھنا اب بھی ممکن ہے۔

کیا آپ گائیڈ دیکھنا پسند کریں گے؟ ٹیوٹوریل Claude Code میں تصاویر تیار کریں Claude سیٹ اپ کا مکمل احاطہ کرتا ہے، جس میں چار حقیقی استعمال کے کیسز اور ان کے حقیقی اخراجات شامل ہیں۔

MCP ایک اوپن پروٹوکول ہے: کوئی بھی کلائنٹ جو Streamable HTTP کو سپورٹ کرتا ہے اور ایک Authorization ہیڈر منسلک کر سکتا ہے، وہ جڑ سکتا ہے۔ موجودہ صورتحال، ہر وینڈر کی باضابطہ دستاویزات سے تصدیق شدہ (آخری بار اگست 2026 میں چیک کیا گیا):

Codex کی مثال — اسے ~/.codex/config.toml میں شامل کریں اور BB_API_KEY=bb_live_… ایکسپورٹ کریں:

[mcp_servers.bananabanana]
url = "https://bananabanana.pro/api/mcp"
bearer_token_env_var = "BB_API_KEY"

Codex کا مکمل گائیڈ — ایک ہی کنفیگریشن سے CLI، IDE ایکسٹینشن اور ChatGPT ڈیسک ٹاپ، بشمول باریکیاں اور لائیو کی ڈیمو: Codex MCP سیٹ اپ: ایک ہی config.toml سے تصاویر اور ویڈیو۔

کیا آپ MCP کلائنٹ استعمال نہیں کر رہے؟ آپ کو اس کی ضرورت نہیں ہے — اور نہ ہی کسی SDK کی ضرورت ہے۔ یہ سرور HTTPS پر ایک سادہ JSON-RPC 2.0 ہے: ایک POST اینڈ پوائنٹ، ایک Bearer ہیڈر، اور ایک سنگل JSON ریسپانس۔ یہ اسٹیٹ لیس (stateless) ہے، اس لیے کسی سیشن ہینڈ شیک کو مینیج کرنے کی ضرورت نہیں ہے — tools/call پہلی ہی ریکوسٹ کے طور پر curl، Python، TypeScript یا کسی بھی ایسی چیز سے کام کرتا ہے جو HTTP بھیج سکتی ہے۔

curl

# start an image generation (charges one image, $0.03 on the default Lite model)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"generate_image",
        "arguments":{"prompt":"studio photo of a ceramic mug on linen, soft daylight"}}}'

# → result.structuredContent.job_id = "cmxy…"

# fetch the result (long-polls server-side up to 30 s; free)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"get_result",
        "arguments":{"job_id":"cmxy…","wait_seconds":30}}}'

Python

صرف requests — کوئی MCP لائبریری نہیں:

import requests

MCP = "https://bananabanana.pro/api/mcp"
HEADERS = {"Authorization": "Bearer bb_live_YOUR_KEY"}

def call(tool, **args):
    r = requests.post(MCP, headers=HEADERS, json={
        "jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": {"name": tool, "arguments": args},
    })
    r.raise_for_status()
    return r.json()["result"]["structuredContent"]

job = call("generate_image", prompt="watercolor painting of a lighthouse at dawn")

result = call("get_result", job_id=job["job_id"], wait_seconds=30)
while result["status"] == "processing":
    result = call("get_result", job_id=job["job_id"], wait_seconds=30)

print(result["files"][0]["url"], "cost:", result["cost_charged_usd"])

TypeScript / Node.js

زیرو ڈپینڈینسیز — بلٹ ان fetch (Node 18+، Deno، Bun، براؤزرز):

const MCP = "https://bananabanana.pro/api/mcp";

async function call(tool: string, args: Record<string, unknown>) {
  const res = await fetch(MCP, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BB_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0", id: 1, method: "tools/call",
      params: { name: tool, arguments: args },
    }),
  });
  const { result } = await res.json();
  return result.structuredContent;
}

const job = await call("generate_image", {
  prompt: "isometric 3D render of a tiny greenhouse at golden hour",
});

let out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
while (out.status === "processing") {
  out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
}
console.log(out.files[0].url, "cost:", out.cost_charged_usd);

وہ تفصیلات جو اسکرپٹ لکھتے وقت اہم ہیں:

• ہر ٹول ریسپانس میں ایک ہی JSON دو بار ہوتا ہے: مشین کے پڑھنے کے قابل result.structuredContent اور result.content میں ایک ٹیکسٹ بلاک — جو بھی آسان ہو اسے پارس کریں۔
• ویڈیو (اور ملٹی امیج بیچز) ایک دو مرحلوں والی کال ہیں: پہلی generate_video ایک کوٹیشن واپس کرتی ہے اور کوئی چارج نہیں لیتی؛ شروع کرنے کے لیے کوٹ کی گئی رقم پر confirm_cost سیٹ کر کے اسے دہرائیں۔
• جنریشن کالز پر ایک idempotency_key پاس کریں — نیٹ ورک کی دوبارہ کوششوں پر کبھی بھی دوہرا چارج نہیں لیا جائے گا۔
• tools/list بغیر کسی کی (key) کے کام کرتا ہے، لہذا آپ اکاؤنٹ بنانے سے پہلے مکمل اسکیمات دیکھ سکتے ہیں۔ ٹول کالز فی کی (key) فی منٹ 20 تک محدود ہیں۔

• قیمتیں list_models کے ذریعے لائیو فراہم کی جاتی ہیں — وہی ذریعہ جو ویب سائٹ استعمال کرتی ہے۔
• ہر ویڈیو (اور ملٹی امیج بیچ) کال پہلے ایک کوٹیشن واپس کرتی ہے اور کوئی چارج نہیں لیتی؛ ایجنٹ شروع کرنے کے لیے confirm_cost کے ساتھ کال دہراتا ہے۔
• ہر رزلٹ میں cost_charged_usd اور balance_remaining_usd شامل ہوتے ہیں۔
• سرور کے مسائل یا مواد کے فلٹر کی وجہ سے مسترد ہونے پر پیسے خودکار طور پر ریفنڈ ہو جاتے ہیں — ویب ایپ جیسی پالیسی۔
• اختیاری idempotency_key اس بات کی ضمانت دیتا ہے کہ دوبارہ کوشش پر کبھی بھی ڈبل چارج نہیں ہوگا۔

• رزلٹ URLs سائنڈ اور 24 گھنٹوں کے لیے کارآمد ہوتے ہیں؛ میڈیا خود آپ کے اکاؤنٹ میں رہتا ہے — تازہ لنکس کے لیے دوبارہ get_result کال کریں، یا ویب سائٹ سے ڈاؤن لوڈ کریں۔
• API کیز کو ہیش کر کے اسٹور کیا جاتا ہے اور تخلیق کے وقت صرف ایک بار دکھایا جاتا ہے؛ اپنے پروفائل میں کسی بھی وقت انہیں منسوخ کریں۔
• OAuth کنکشنز کے ایکسیس ٹوکن ایک گھنٹہ چلتے ہیں اور ریفریش ٹوکن ہر بار بدل جاتا ہے؛ صرف ہیش محفوظ ہوتے ہیں اور یہ فقط اسی سرور کے لیے کارآمد ہیں۔ پروفائل سے ایپ منقطع کرتے ہی ٹوکن فوراً بے کار ہو جاتے ہیں۔
• فی کی (key) استعمال کا لاگ (ٹول، ماڈل، لاگت، پرامپٹ پریویو) Profile → MCP API Keys میں دیکھا جا سکتا ہے۔
• MCP جنریشنز اسی جنریشن ہسٹری اور اینالیٹکس میں ظاہر ہوتی ہیں جیسے کہ ویب جنریشنز۔

x402 ایک کھلا پروٹوکول ہے جس کے ذریعے ایجنٹ ایک درخواست کی ادائیگی اسٹیبل کوائن سے کرتا ہے۔ یہ MCP سرور سے الگ اینڈ پوائنٹ ہے: POST /api/x402۔ اکاؤنٹ، API کلید یا بیلنس ٹاپ اپ کی ضرورت نہیں۔

1. ٹول کا نام اور اس کے آرگیومنٹس بھیجیں۔ سرور اس کال کی درست قیمت کے ساتھ 402 واپس کرتا ہے۔
2. Base نیٹ ورک پر USDC میں ادائیگی پر دستخط کریں اور X-PAYMENT ہیڈر کے ساتھ درخواست دوبارہ بھیجیں۔
3. تصاویر اور آواز اسی جواب میں ملتی ہیں۔ ویڈیو job_id واپس کرتی ہے؛ نتیجہ GET /api/x402/result/{jobId} سے مفت معلوم کریں۔

دستیاب ٹولز: generate_image، generate_speech، generate_video۔ قیمتیں ویب اسٹوڈیو اور MCP جیسی ہی ہیں؛ کال کی قیمت وہی ہے جو جنریشن کی ہے، کم از کم ٹاپ اپ کوئی نہیں۔

اگر ادا شدہ ویڈیو ناکام ہو جائے تو ادائیگی کرنے والے کو اتنی ہی رقم کا کریڈٹ ٹوکن ملتا ہے جو 90 دن تک کارآمد رہتا ہے۔ اسے اگلی کال میں refund_token کے طور پر بھیجیں۔ ادائیگیاں آن چین واپس نہیں ہوتیں۔ موجودہ قیمتوں والا مشین ریڈایبل کیٹلاگ GET /api/x402 پر ہے۔