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 移动端、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。

图像和视频生成是异步的：生成/编辑调用返回一个 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。

图像每张 $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"

链接

• 网站： 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。本仓库仅为公开文档——不包含任何服务器源代码、密钥或机密信息。