BananaBanana MCP Server

이미지, 비디오, 음성 생성을 위한 MCP 서버 — Google Nano Banana, Veo, Omni, Gemini TTS 모델 — 모든 MCP 클라이언트(Claude Code, Claude Desktop, Cursor 등)가 구독 없이 암호화폐 결제로 미디어를 사용한 만큼만 생성할 수 있게 해줍니다.

• 엔드포인트: https://bananabanana.pro/api/mcp (streamable 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를 누르고 액세스를 승인하세요. 데스크톱 빌드가 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로 호출을 반복하기 전까지는 청구되지 않습니다.

가격

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초를 허용합니다. 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. 이 저장소는 공개 문서 전용입니다 — 서버 소스 코드, 키 또는 비밀을 포함하지 않습니다.