Skip to main content
Glama

BananaBanana MCP Server

一个用于图像、视频和语音生成的 MCP 服务器——支持 Google Nano Banana、Veo、Omni 和 Gemini TTS 模型——让任何 MCP 客户端(Claude Code、Claude Desktop、Cursor 等)都能以按需付费的方式创建媒体,支持加密货币支付,无需订阅。

图像生成低至 $0.03,视频低至 $0.10,语音按每 200 个已开始计费的转录字符 $0.01,从你用加密货币充值的账户余额中扣费。每次高成本调用前都会提供费用报价,失败时自动退款,并与网站共享同一份图像/视频历史记录。

快速开始

OAuth 是主要的连接方式。API 密钥仍可供不支持 OAuth 的客户端以及脚本或 CI 使用:

  • OAuth 2.1(claude.ai、Claude Desktop、Claude 移动端、Claude Code、MCP Inspector): 添加上面 URL 的自定义连接器,点击 Connect 并批准访问。无需复制密钥。参见 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

使用 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。

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

工具

共九个工具;只读工具免费。完整参考见 docs/tools.md。

工具

功能

关键参数

list_models

列出带有实时美元价格、分辨率、时长、限制的模型。免费。

—

get_account

余额、密钥名称、每日上限、今日消费。免费。

—

generate_image

文生图(Nano Banana 2 Lite / 2 / Pro),最高 4K,1–4 个变体。返回一个 job_id。

prompt、model、aspect_ratio、resolution、number_of_images、confirm_cost

edit_image

通过文本指令对已完成的图像进行多轮编辑。

source_generation_id、prompt、model、resolution

generate_video

视频生成(Veo 3.1 系列或 Omni Flash),可选起始帧和参考图像。始终先报价。返回一个 job_id。

prompt、model、duration、resolution、with_audio、first_frame、reference_images、confirm_cost

edit_video

在 Omni Flash 上进行视频到视频编辑:重设风格、替换对象、重新布光现有片段。始终先报价。

prompt、source_generation_id 或 video_url、duration、audio_prompt、confirm_cost

generate_speech

Gemini 3.1 Flash TTS 语音:单说话人或双说话人对话。同步返回托管的 WAV URL。

text、voice、language_code、style、speakers

get_result

轮询任务;返回托管的媒体 URL(24 小时)+ 费用/余额。免费。

job_id、wait_seconds

list_generations

最近的账户历史记录(与网站共享)。免费。

limit、type、status

图像和视频生成是异步的:生成/编辑调用返回一个 job_id;通过 get_result 轮询获取媒体。generate_speech 是同步的,直接返回其 WAV URL。generate_video、edit_video 和多图像 generate_image 先报价,在你使用 confirm_cost 重复调用之前不收取任何费用。

定价

按需付费,以美元计:按张计费图像、按条计费 Veo 片段、按秒计费 Omni Flash、按每 200 个已开始计费的转录字符计费语音。实时数字来自 list_models;完整表格见 docs/pricing.md。

模型

类型

价格

nano-banana-2-lite

图像(1024)

$0.03

nano-banana-2

图像(512→4096)

$0.03 – $0.13

nano-banana-pro

图像(1024→4096)

$0.11 – $0.20

veo-3.1-lite

视频(720p/1080p;4、6 或 8 秒)

$0.10 – $0.56

veo-3.1-fast

视频(最高 4K;4、6 或 8 秒)

$0.35 – $2.60

veo-3.1

视频(最高 4K;4、6 或 8 秒)

$0.70 – $4.40

omni-flash

视频(720p、有声、3–10 秒)

$0.10 / 秒($0.30 – $1.00)

gemini-3.1-flash-tts-preview

语音(WAV)

$0.01 / 每 200 个已开始计费的转录字符

图像每张 $0.03–$0.20;视频每条 $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 返回实时价格,视频/批量调用返回报价并在确认前不收费——因此代理不会产生意外账单。

  • 失败不会让你花钱。 上游错误和内容过滤拒绝会自动退款;可选的每密钥每日上限和 idempotency_key 进一步限制了风险。

  • 加密货币充值,无需银行卡。 充值 $50+ / $100+ 可获得 5% / 10% 额外余额,有效的合作伙伴促销代码可再增加 10%。MCP 和网站共享同一个余额和同一份图像/视频历史记录。

注册表

已发布在官方 MCP Registry 中,名称为 pro.bananabanana/image-video。规范描述符是 server.json。查询方式:

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

链接

许可证

Apache-2.0 © BananaBanana。本仓库仅为公开文档——不包含任何服务器源代码、密钥或机密信息。

Related MCP Connectors

Related MCP Servers