BananaBanana MCP Server

画像・動画・音声生成のためのMCPサーバー — Google Nano Banana、Veo、Omni、Gemini TTS モデル — あらゆるMCPクライアント（Claude Code、Claude Desktop、Cursor など）が、暗号通貨決済による従量課金で、サブスクリプションなしでメディアを生成できます。

• エンドポイント: https://bananabanana.pro/api/mcp（ストリーミングHTTP）

• 認証: OAuth 2.1（サインインするだけ、コピー不要）または Authorization: Bearer bb_live_… — キーを作成

• ウェブサイト: https://bananabanana.pro · ドキュメントとライブ例: https://bananabanana.pro/mcp

画像は$0.03から、動画は$0.10から、音声は200トランスクリプト文字ごとに$0.01で生成できます。料金は暗号通貨でチャージするアカウント残高から請求されます。高額な呼び出しの前には必ず料金の見積もりが表示され、失敗時には自動返金されます。また、ウェブサイトと画像・動画の履歴を共有します。

クイックスタート

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

• OAuth 2.1（claude.ai、Claude Desktop、Claude mobile、Claude Code、MCP Inspector）: 上記のURLでカスタムコネクタを追加し、[接続]を押してアクセスを承認します。キーのコピーは不要です。docs/authentication.md を参照してください。

• APIキー（Cursor、VS Code、Windsurf、Codex、スクリプト、CI）: プロフィール（https://bananabanana.pro/profile）の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

設定 → コネクタ → カスタムコネクタを追加 で https://bananabanana.pro/api/mcp を入力し、接続 を押してアクセスを承認します。お使いのデスクトップビルドが 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 を参照してください。

Cursor — ~/.cursor/mcp.json（グローバル）または .cursor/mcp.json（プロジェクト）:

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

VS Code — .vscode/mcp.json（キーは暗号化されたプロンプトとして保存されます）:

{
  "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 }
  ]
}

Windsurf — ~/.codeium/windsurf/mcp_config.json:

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

コピーして使える設定は examples/ にあります。接続後、エージェントに list_models（無料）を実行するよう依頼すると、最新のモデル一覧と料金が返されます。

MCPクライアントがありませんか？ このサーバーはHTTPS上のプレーンなJSON-RPCです。SDKなしでcurl、Python、TypeScriptから呼び出せます: examples/no-sdk.md（実行可能スクリプト: generate.py、generate.mjs）。

Related MCP server: Nanana AI Image Generation Server

ツール

9つのツールがあります。読み取り専用のものは無料です。完全なリファレンスは docs/tools.md にあります。

画像・動画の生成は非同期です。生成/編集の呼び出しは job_id を返し、get_result でメディアをポーリングします。generate_speech は同期で、WAV URLを直接返します。generate_video、edit_video、複数画像の generate_image は最初に見積もりを表示し、confirm_cost を付けて呼び出すまで課金されません。

料金

米ドル建ての従量課金制です。画像は1枚ごと、Veoクリップは1本ごと、Omni Flashは1秒ごと、音声は200トランスクリプト文字ごとに課金されます。最新の料金は list_models で確認できます。完全な表は docs/pricing.md にあります。

画像は1枚あたり $0.03〜$0.20、動画は1クリップあたり $0.10〜$4.40（Omni Flashは $0.10/秒）です。Veo生成は4、6、8秒に対応しています。list_models が返す7秒の料金は拡張ジョブ用であり、選択可能な generate_video の長さではありません。無料の読み取り: list_models、get_account、get_result、list_generations。失敗した生成やコンテンツフィルターに掛かった生成は自動的に返金されます。

チャージボーナスで実質コストを下げられます。$50以上の入金で5%、$100以上で10%のボーナス残高が付与され、パートナープロモコードを利用するとさらに10%追加されます。ボーナスは重複します。表は通常の生成料金を示しており、実質自己負担額はチャージボーナスによって異なります。

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

• 生成した分だけ支払う、それだけです。 月額料金も、シート料金も、失効するクレジットもありません。使わない月は$0です。チャージした残高だけが唯一の支払いです。

• エージェントは使う前に価格を確認します。 list_models は最新の価格を返し、動画・バッチ呼び出しは見積もりを返し、確認するまで課金されません。つまり、エージェントが予期せぬ請求をすることはありません。

• 失敗してもコストはかかりません。 上流のエラーやコンテンツフィルターによる拒否は自動的に返金されます。オプションのキーごとの1日あたりの上限と idempotency_key により、さらなるリスクを抑えられます。

• カード不要、暗号通貨でチャージ。 $50以上で5%、$100以上で10%のボーナス残高が付与され、アクティブなパートナープロモコードでさらに10%追加されます。残高と画像・動画の履歴はMCPとウェブサイトで共有されます。

レジストリ

公式の MCPレジストリ に pro.bananabanana/image-video として公開されています。正規の記述子は server.json です。検索するには:

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

リンク

• ウェブサイト: https://bananabanana.pro

• MCPドキュメントとライブ例: https://bananabanana.pro/mcp

• APIキーの作成: https://bananabanana.pro/profile

• 認証 · docs/authentication.md

• ツールリファレンス · docs/tools.md

• 料金と制限 · docs/pricing.md

• トラブルシューティング · docs/troubleshooting.md

• サポート: support@bananabanana.pro

ライセンス

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