BananaBanana

BananaBanana MCP Server

画像、動画、音声の生成に対応する MCP サーバーです。Google Nano Banana、Veo 3.1、Gemini Omni、OpenAI GPT Image 2.5、Alibaba Qwen Image、Wan 3.0、xAI Grok Imagine Video、Gemini TTSを使って、あらゆる MCP クライアント（Claude Code、Claude Desktop、Cursor など）から、サブスクリプション不要で暗号資産またはカード決済による従量課金制でメディアを作成できます。

• エンドポイント： https://bananabanana.pro/api/mcp（ストリーミング可能な HTTP）
• 認証： OAuth 2.1（サインインするだけで、コピーするものはありません）、または Authorization: Bearer bb_live_… — キーを作成
• ウェブサイト： https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog · ドキュメントとライブデモ： https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog

画像は $0.03 から、動画は $0.09 から生成でき、音声は文字起こし文字数が 200 文字に達するごとに $0.01 です。料金は、暗号資産（$1 から）またはカード、PayPal、SEPA（$20 から）でチャージしたアカウント残高から差し引かれます。高額な呼び出しの前には毎回料金が提示され、失敗時は自動返金されます。画像と動画の履歴はウェブサイトと共有されます。

現行ドキュメントリリース：v1.0.12 — 2026-09-30 時点で、デプロイ済みのツールスキーマとモデルカタログに照らして監査済みです。変更履歴をご覧ください。

クイックスタート

OAuth が主な接続方法です。OAuth に対応していないクライアントやスクリプト、CI では、引き続き API キーを利用できます。

• OAuth 2.1（claude.ai、Claude Desktop、Claude モバイル、Claude Code、MCP Inspector）：上記の URL を使ってカスタムコネクターを追加し、［接続］を押してアクセスを承認します。コピーするキーはありません。docs/authentication.mdをご覧ください。
• API キー（Cursor、VS Code、Windsurf、Codex、スクリプト、CI）：プロフィール — https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog の API Keys セクション — でキーを作成し、以下のようにクライアント設定に追加します。

claude.ai / Claude Desktop / モバイル（OAuth）

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

Claude Code

# OAuth — no key; run /mcp inside Claude Code and choose "Authenticate"
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp

# API-key fallback for non-interactive use
claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

Claude Desktop

Settings → Connectors → Add custom connector を使って https://bananabanana.pro/api/mcp を入力し、Connect を押してアクセスを承認します。お使いの Desktop ビルドで claude_desktop_config.json を使う場合、OAuth に対応する mcp-remote ブリッジにはNode.jsが必要です。

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

初回使用時に、ブリッジによって OAuth サインインフローが開きます。API キーを使う場合の代替方法は docs/authentication.mdをご覧ください。

{
  "mcpServers": {
    "bananabanana": {
      "url": "https://bananabanana.pro/api/mcp",
      "headers": { "Authorization": "Bearer bb_live_YOUR_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 }
  ]
}

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

すぐにコピーして使える設定は examples/ にあります。接続したら、エージェントに list_models（無料）を実行するよう頼んでください。利用可能なモデルと料金の最新一覧が返されます。OAuth ユーザーは、エージェントに top_up の呼び出しを頼むこともできます。返されるブラウザーリンクでは、プロフィール全体を公開することなく、入金のみを行えます。

MCP クライアントをお持ちでない場合：このサーバーは HTTPS 経由の通常の JSON-RPC です。SDK を使わずに curl、Python、TypeScript から呼び出せます。examples/no-sdk.md（実行可能なスクリプト：generate.py、generate.mjs）をご覧ください。

ツール

10 個のツールがあります。読み取り専用ツールとアカウントアクセスツールは無料です。詳細なリファレンスは docs/tools.md をご覧ください。

画像と動画の生成は非同期です。生成／編集の呼び出しは job_id を返すため、メディアを取得するには get_result を呼び出してください。generate_speech は同期処理で、WAV URL を 直接返します。generate_video、edit_video、および複数画像を使った generate_image は、最初に料金を見積もり、 confirm_cost を指定して再度呼び出すまで課金されません。

生成ファイルは作成から 30 日間 保持されます。署名付きダウンロードリンクの有効期限は 24 時間です。 保持期間内であれば、get_result から新しい画像／動画リンクを取得できます。音声は同期応答から ダウンロードしてください。list_generations には表示されません。

料金

米ドル建ての従量課金です。画像は1枚ごと、Veo のクリップは1本ごと、Omni Flash、 Wan 3.0、Grok Imagine Video は出力1秒ごと、音声は文字起こし200文字ごとに課金されます。 最新の料金は list_models から取得できます。料金表の全一覧は docs/pricing.md をご覧ください。

画像は1枚あたり**$0.03–$0.20**、動画は1クリップあたり**$0.09–$6.00**です。Veo は クリップごとに課金されます。一方、Omni Flash、Wan 3.0、Grok Imagine Video は、ベンダー独自の 通常料金で出力1秒ごとに課金されます。Veo では4秒、6秒、または8秒の動画を生成できます。 list_models が返す7秒の料金は延長ジョブ向けであり、generate_video で選択できる 長さではありません。Wan 3.0 では、最初と最後のフレーム、参照画像、参照動画、シードを指定でき、 音声トラックは無料でオフにできます。無料ツール： list_models、get_account、top_up、get_result、list_generations。生成に失敗した場合や コンテンツフィルターにより拒否された場合は、自動的に返金されます。

トップアップボーナスにより、実質的な料金を抑えられます。$50以上の入金には残高が5%、 $100以上の入金には10%追加され、有効なパートナーのプロモコードを使うとさらに 10%追加されます。ボーナスは併用でき、暗号資産とカードのどちらの入金にも適用されます。表に記載された 料金は通常の生成料金です。実質的な自己負担額はトップアップボーナスによって異なります。プロモコードを 利用するには通常のサインイン済みプロフィールが必要です。入金のみの OAuth セッションでは意図的に 利用できないようになっています。

サブスクリプションサービスではなく、これを選ぶ理由

• 生成した分だけお支払いいただけます。それ以外の料金はありません。 月額料金も、シート料金も、 期限切れになるクレジットもありません。利用しない月の料金は$0で、トップアップした残高だけが 支出となります。
• エージェントは支出前に料金を確認できます。 list_models は最新の料金を返し、動画やバッチの 呼び出しでは見積もりが返されます。確認されるまでは課金されないため、エージェントが予期せぬ 高額請求を発生させることはありません。
• 失敗しても料金はかかりません。 上流エラーやコンテンツフィルターによる拒否は自動的に返金されます。 オプションの日次キー別上限と idempotency_key を設定すれば、損失リスクをさらに抑えられます。
• 暗号資産またはカードで支払い、サブスクリプションは不要です。 暗号資産のトップアップは$1から 可能です（ほとんどのネットワークでUSDT、USDC、DAIなどに対応）。カード、PayPal、SEPA（EU）の トップアップは$20からで、PayPalのチェックアウト内で処理されるため、カード情報がサービスに 渡ることはありません。$50以上／$100以上の入金には残高が5%／10%追加され、有効なパートナーの プロモコードを使うとさらに10%追加されます。MCPとウェブサイトでは、1つの残高と画像・動画の履歴を 共有します。

アカウント不要の従量課金（x402）

別の HTTP エンドポイント https://bananabanana.pro/api/x402 では、アカウント、OAuth、API キーなしで Base 上の USDC を受け付けます。画像、動画、音声の生成に対応しています。画像と音声の支払いは成功後に決済されます。動画は前払いで、失敗した場合は使い切りの返金クレジットトークンが返されます。リクエスト形式、正確な価格のチャレンジ、ポーリング、入力制限については、docs/x402.md をご覧ください。

レジストリ

公式の MCP Registry に pro.bananabanana/image-video として登録されています。正規の記述ファイルは server.json です。検索するには、次のコマンドを実行してください。

curl -s "https://registry.modelcontextprotocol.io/v0/servers?search=pro.bananabanana/image-video"

リンク

• ウェブサイト： https://bananabanana.pro/?utm_source=mcp_readme&utm_medium=mcp_catalog
• MCP のドキュメントとライブサンプル： https://bananabanana.pro/mcp?utm_source=mcp_readme&utm_medium=mcp_catalog
• API キーを作成： https://bananabanana.pro/profile?utm_source=mcp_readme&utm_medium=mcp_catalog
• x402 従量課金 · docs/x402.md
• 認証 · docs/authentication.md
• ツールのリファレンス · docs/tools.md
• 料金と制限 · docs/pricing.md
• トラブルシューティング · docs/troubleshooting.md
• サポート： [email protected]

ライセンス

Apache-2.0 © BananaBanana。このリポジトリは公開ドキュメントのみで構成されており、サーバーのソースコード、キー、シークレットは含まれていません。