gobananas-cli

gobananas-cli

Interactive command-line interface and MCP proxy for Go Bananas AI image generation.

What's New (v1.0.6)

• Prompt Optimization: New enhance_prompt parameter enriches short prompts with AI-powered visual details (lighting, composition, style) before generation
• Timeout Fix: Fixed MCP SDK 60s timeout causing -32001 errors on parallel Pro model requests. Now uses 10-minute timeout with progress-based keep-alive.

Install

npm install -g gobananas-cli

Or use without installing:

npx gobananas-cli

Commands

Command	Alias	Description
gobananas	gb	Interactive CLI
gobananas-mcp	—	MCP STDIO proxy for AI editors

MCP Setup

Go Bananas supports two MCP auth modes. Pick one per client/scope:

• Remote HTTP OAuth: the MCP client connects to https://gobananasai.com/mcp and stores its own OAuth tokens.
• STDIO proxy: the MCP client launches gobananas-mcp; the proxy reads credentials from gobananas-cli auth login or GO_BANANAS_API_KEY.

Do not expect gobananas-cli auth login to authenticate a direct HTTP MCP entry. It only authenticates the STDIO proxy.

For Claude Code, claude.ai connectors, Codex, Cursor, VS Code, and other clients that support remote HTTP MCP OAuth, use the hosted endpoint:

claude mcp add --transport http -s user go-bananas https://gobananasai.com/mcp

Then run /mcp in Claude Code and complete the Go Bananas browser login.

Codex uses:

codex mcp add go-bananas --url https://gobananasai.com/mcp
codex mcp login go-bananas

Use the local STDIO proxy for MCP clients that cannot connect to remote HTTP servers, or when you want one local credential shared across STDIO clients. Run browser login once:

npx -y gobananas-cli auth login

Then configure the proxy:

{
  "mcpServers": {
    "go-bananas": {
      "command": "npx",
      "args": ["-y", "gobananas-mcp"],
      "env": {
        "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
        "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
      }
    }
  }
}

For CI/headless environments, add GO_BANANAS_API_KEY to the same env object instead of using browser login.

See the gobananas-mcp README for client-specific setup instructions.

Environment Variables

Variable	Default	Description
GO_BANANAS_API_KEY	—	API-key fallback for STDIO proxy and CI/headless clients
GO_BANANAS_SERVER_URL	https://gobananasai.com	Server URL
GO_BANANAS_MCP_TRANSPORT	streamable-http	Transport protocol

Architecture

• src/ — TypeScript source
• dist/ — Compiled output
• bin/ — CLI entry points (gobananas.js, gobananas-mcp.js)

The MCP STDIO proxy (bin/gobananas-mcp.js) bridges STDIO-based MCP clients to the remote server using Streamable HTTP transport with a 30s connect timeout and 10-minute request timeout.

Related

• gobananas-mcp — MCP proxy package (zero-install npx setup)
• Go Bananas — AI image generation platform