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