BananaBanana MCP Server

Удаленный сервер Model Context Protocol, который открывает вашим агентам доступ ко всему стеку генерации BananaBanana через встроенные инструменты: изображениям Google Nano Banana 2 Lite / 2 / Pro (от $0.03), видео Veo 3.1 / Fast / Lite и Gemini Omni Flash со звуком (фикс. $1.00). Агент видит актуальные цены, подтверждает расходы перед дорогими задачами, а все генерации сохраняются в той же истории и оплачиваются с того же баланса, что и на сайте.

• Эндпоинт: https://bananabanana.pro/api/mcp (Streamable HTTP)
• Авторизация: Bearer API-ключ из вашего профиля (в планах — поддержка OAuth 2.1)
• Лимит запросов: 20 вызовов инструментов в минуту на один ключ; можно настроить дневной лимит расходов для каждого ключа
• Нет MCP-клиента? Этот же эндпоинт работает как обычный JSON-RPC по HTTPS — вызывайте его через curl, Python или TypeScript без установки SDK
• Неудачные или отклоненные фильтрами генерации возвращаются на баланс автоматически
• Документация, файл server.json и готовые примеры настройки клиентов доступны в GitHub-репозитории bananabanana-mcp

1. Создайте аккаунт и пополните баланс. 2. В разделе Profile → MCP API Keys создайте ключ (он показывается один раз). 3. Добавьте сервер в свой клиент:

Claude Code

claude mcp add --transport http bananabanana https://bananabanana.pro/api/mcp \
  --header "Authorization: Bearer bb_live_YOUR_KEY"

Claude Desktop

Добавьте в claude_desktop_config.json (Settings → Developer → Edit Config); для работы моста mcp-remote требуется Node.js:

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

Cursor

Добавьте в глобальный файл ~/.cursor/mcp.json или локальный .cursor/mcp.json в корне проекта. Чтобы не хранить ключ в файле в открытом виде, используйте переменную окружения ${env:BB_API_KEY}:

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

Подробный разбор интеграции с Cursor с описанием нюансов и демо-ключом: Генерация изображений в Cursor.

VS Code / GitHub Copilot

Добавьте в файл .vscode/mcp.json в рабочей области (или в пользовательские настройки settings.json). VS Code запросит ключ один раз и сохранит его в зашифрованном виде:

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

Подробный разбор интеграции с VS Code / Copilot с описанием нюансов и демо-ключом: Генерация изображений в VS Code: руководство по настройке Copilot MCP.

Windsurf

Добавьте в ~/.codeium/windsurf/mcp_config.json:

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

Любой другой MCP-клиент (чистый JSON-RPC)

POST https://bananabanana.pro/api/mcp
Authorization: Bearer bb_live_YOUR_KEY
Content-Type: application/json
Accept: application/json, text/event-stream

{"jsonrpc":"2.0","id":1,"method":"tools/list"}

Предпочитаете пошаговые инструкции? Руководство Генерация изображений в Claude Code подробно описывает весь процесс настройки Claude от начала до конца, включая четыре реальных сценария использования и расчет их стоимости.

MCP — открытый протокол. К нему может подключиться любой клиент, поддерживающий Streamable HTTP и умеющий передавать заголовок Authorization. Текущий статус интеграции проверен по официальной документации разработчиков (актуально на июль 2026 года):

Пример для Codex — добавьте в ~/.codex/config.toml и экспортируйте BB_API_KEY=bb_live_…:

[mcp_servers.bananabanana]
url = "https://bananabanana.pro/api/mcp"
bearer_token_env_var = "BB_API_KEY"

Подробный разбор интеграции с Codex (CLI, расширение для IDE и десктопное приложение ChatGPT из единой конфигурации) с описанием нюансов и демо-ключом: Настройка Codex MCP: генерация изображений и видео из одного config.toml.

Не пользуетесь MCP-клиентами? Они и не нужны — как и специальные библиотеки (SDK). Сервер работает по обычному протоколу JSON-RPC 2.0 поверх HTTPS: один эндпоинт для POST-запросов, заголовок Bearer и простой JSON-ответ в один шаг. Состояние сессии не сохраняется (stateless), поэтому никакого предварительного рукопожатия не требуется: запрос к tools/call можно отправлять сразу через curl, Python, TypeScript или любой другой инструмент для работы с HTTP.

curl

# start an image generation (charges one image, $0.06 on the default model)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{
        "name":"generate_image",
        "arguments":{"prompt":"studio photo of a ceramic mug on linen, soft daylight"}}}'

# → result.structuredContent.job_id = "cmxy…"

# fetch the result (long-polls server-side up to 30 s; free)
curl -s https://bananabanana.pro/api/mcp \
  -H "Authorization: Bearer bb_live_YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{
        "name":"get_result",
        "arguments":{"job_id":"cmxy…","wait_seconds":30}}}'

Python

Только библиотека requests — никаких сторонних MCP-библиотек:

import requests

MCP = "https://bananabanana.pro/api/mcp"
HEADERS = {"Authorization": "Bearer bb_live_YOUR_KEY"}

def call(tool, **args):
    r = requests.post(MCP, headers=HEADERS, json={
        "jsonrpc": "2.0", "id": 1, "method": "tools/call",
        "params": {"name": tool, "arguments": args},
    })
    r.raise_for_status()
    return r.json()["result"]["structuredContent"]

job = call("generate_image", prompt="watercolor painting of a lighthouse at dawn")

result = call("get_result", job_id=job["job_id"], wait_seconds=30)
while result["status"] == "processing":
    result = call("get_result", job_id=job["job_id"], wait_seconds=30)

print(result["files"][0]["url"], "cost:", result["cost_charged_usd"])

TypeScript / Node.js

Ноль зависимостей — стандартный fetch (Node 18+, Deno, Bun, браузеры):

const MCP = "https://bananabanana.pro/api/mcp";

async function call(tool: string, args: Record<string, unknown>) {
  const res = await fetch(MCP, {
    method: "POST",
    headers: {
      Authorization: `Bearer ${process.env.BB_API_KEY}`,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      jsonrpc: "2.0", id: 1, method: "tools/call",
      params: { name: tool, arguments: args },
    }),
  });
  const { result } = await res.json();
  return result.structuredContent;
}

const job = await call("generate_image", {
  prompt: "isometric 3D render of a tiny greenhouse at golden hour",
});

let out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
while (out.status === "processing") {
  out = await call("get_result", { job_id: job.job_id, wait_seconds: 30 });
}
console.log(out.files[0].url, "cost:", out.cost_charged_usd);

Важные детали для написания скриптов:

• Каждый ответ инструмента дублирует данные: в машиночитаемом формате в result.structuredContent и в виде текста в result.content — разбирайте то, что удобнее.
• Создание видео (и пакетов из нескольких картинок) происходит в два шага: первый вызов generate_video возвращает предварительный расчет стоимости и ничего не списывает; повторите его с параметром confirm_cost, равным рассчитанной сумме, чтобы запустить генерацию.
• Передавайте уникальный idempotency_key при вызовах генерации — повторные попытки из-за сбоев сети никогда не приведут к двойному списанию.
• Метод tools/list работает без авторизации по ключу, поэтому вы можете изучить полные схемы параметров еще до регистрации. Лимит вызовов инструментов — 20 в минуту на один ключ.

• Цены подтягиваются в реальном времени через list_models — из того же источника, что и на сайте.
• Каждый вызов для генерации видео (или пакета картинок) сначала возвращает расчет стоимости без списания средств. Для запуска задачи агент повторяет вызов с параметром confirm_cost.
• Каждый результат содержит поля cost_charged_usd (фактическая стоимость) и balance_remaining_usd (остаток на балансе).
• Ошибки на стороне провайдеров моделей и отклонения по контент-фильтрам компенсируются автоматически — точно так же, как и в веб-интерфейсе.
• Необязательный параметр idempotency_key гарантирует, что повторные попытки запросов никогда не приведут к двойному списанию.

→ generate_video {"prompt": "drone shot over a misty pine forest", "model": "veo-3.1-fast"}
← {"status": "confirmation_required", "quoted_cost_usd": 0.70, ...}
→ generate_video {..., "confirm_cost": 0.70}
← {"job_id": "cmxy…", "status": "processing", "cost_charged_usd": 0.70, "balance_remaining_usd": 12.40}
→ get_result {"job_id": "cmxy…"}
← {"status": "completed", "files": [{"url": "https://…"}], "cost_charged_usd": 0.70}

• Ссылки на результаты подписаны шифрованием и активны в течение 24 часов. Сами медиафайлы надежно хранятся в вашем аккаунте: вы можете получить новые ссылки повторным вызовом get_result или скачать файлы через сайт.
• API-ключи хранятся в виде хэшей и показываются только один раз при создании. Вы можете отозвать их в любой момент в своем профиле.
• Детальный лог использования каждого ключа (инструмент, модель, стоимость, превью промпта) доступен в Profile → MCP API Keys.
• Все генерации через MCP отображаются в общей истории генераций и аналитике наряду с веб-версией.