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 и речь за $0,01 за каждые начатые 200 символов транскрипта, списывая с баланса аккаунта, который вы пополняете криптовалютой. Смета расходов перед каждым дорогостоящим вызовом, автоматический возврат средств при сбое и единая общая история изображений и видео с веб-сайтом.

Быстрый старт

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 / mobile (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, затем нажмите Подключиться и подтвердите доступ. Если ваша сборка Desktop использует claude_desktop_config.json, мост mcp-remote с поддержкой OAuth требует Node.js:

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

Мост запускает процесс входа через OAuth при первом использовании. См. docs/authentication.md о запасном варианте с API-ключом.

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-клиента? Сервер — это обычный JSON-RPC поверх HTTPS — вызывайте его из curl, Python или TypeScript без SDK: 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 синхронен и сразу возвращает URL WAV-файла. generate_video, edit_video и generate_image с несколькими изображениями сначала показывают смету и ничего не списывают, пока вы не повторите вызов с confirm_cost.

Цены

Оплата по мере использования в USD: за изображение, за клип 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 секунд; цены за 7 секунд, возвращаемые list_models, относятся к заданиям на продление, а не к выбираемой длительности 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 как 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. Этот репозиторий — только публичная документация; в нём нет исходного кода сервера, ключей или секретов.