gobananas-mcp

MCP server for Go Bananas AI image generation. Connects MCP clients (Claude Desktop, Claude Code, Cursor, VS Code, Codex) to the Go Bananas server.

47 tools for image generation, conversational editing, character consistency, product marketing, posters, style presets, model discovery, quota/cost checks, and analytics — powered by Gemini Flash, Gemini Pro, and OpenAI GPT Image 2.

What's New (v1.0.7)

• 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.

Quick Start

Auth Modes

There are two supported ways to connect:

| Mode | Best For | How Auth Works | | --------------------- | ----------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------- | | Remote HTTP OAuth | claude.ai connectors, Claude Code, Codex, Cursor/VS Code clients that support remote MCP OAuth | The client connects to https://gobananasai.com/mcp and stores OAuth tokens for that URL | | STDIO proxy | Claude Desktop config files, older editors, Hermes/cloud agents, or clients without remote HTTP OAuth | The client launches gobananas-mcp; the proxy reads local gobananas-cli OAuth tokens or GO_BANANAS_API_KEY |

Keep only one go-bananas entry per client/scope. Logging in with npx -y gobananas-cli auth login authenticates the STDIO proxy only; it does not authenticate a separate direct HTTP config entry.

Claude Desktop / claude.ai Remote Connector

No installation needed when using the hosted connector flow:

1. Go to Settings > Connectors > Add custom connector
2. Enter URL: https://gobananasai.com/mcp
3. Authenticate with your Go Bananas account

That's it. All 47 tools are available immediately.

Claude Code (Recommended — Remote HTTP OAuth)

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

Then run /mcp in Claude Code and authenticate in the browser. This uses Go Bananas OAuth; you do not need to paste an API key into your MCP config.

Codex (Remote HTTP OAuth)

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

Use codex mcp get go-bananas to verify the configured endpoint.

Universal Install (9+ Clients)

Works across Claude, Cursor, VS Code, Gemini CLI, and more:

npx add-mcp https://gobananasai.com/mcp

STDIO Clients / Hermes / Cloud Agents

If your client cannot use remote HTTP MCP connectors, use this local STDIO proxy. Run browser login once, then point the client at gobananas-mcp without putting an API key in the MCP config:

npx -y gobananas-cli auth login

This opens Go Bananas in your browser, stores OAuth tokens locally, and the STDIO proxy automatically sends/refreshes bearer tokens when connecting upstream.

Then add the proxy to your MCP config.

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving.

For Claude Code STDIO:

claude mcp add -s user go-bananas \
  -e GO_BANANAS_SERVER_URL=https://gobananasai.com \
  -e GO_BANANAS_MCP_TRANSPORT=streamable-http \
  -- npx -y gobananas-mcp

For Codex STDIO:

codex mcp add go-bananas \
  --env GO_BANANAS_SERVER_URL=https://gobananasai.com \
  --env GO_BANANAS_MCP_TRANSPORT=streamable-http \
  -- npx -y gobananas-mcp

For headless/cloud environments, run npx -y gobananas-cli auth login --no-open and open the printed authorization URL in a browser that can reach the local callback address. If that is not possible, use the API-key fallback:

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

Cursor

Prefer remote HTTP OAuth when supported:

{
  "mcpServers": {
    "go-bananas": {
      "type": "http",
      "url": "https://gobananasai.com/mcp"
    }
  }
}

Otherwise add the STDIO proxy to .cursor/mcp.json after running npx -y gobananas-cli auth login:

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

Global Install

npm install -g gobananas-mcp

Then use "command": "gobananas-mcp" without the args field.

What You Can Do

| Category | Tools | Examples | | ---------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------ | | Generate | generate_image, batch_generate | Create images from text prompts (use enhance_prompt for AI-enhanced results) | | Edit | edit_image, continue_editing | "add clouds", "make it brighter" | | Characters | create_character, generate_with_character | Consistent characters across scenes | | Products | create_product_reference, generate_with_product | Marketing images with real products | | Styles | create_style_preset, list_style_presets | Reusable brand templates | | Models & Analytics | list_models, check_quota, get_usage_stats | Capability discovery, cost estimates, quota tracking |

Run list_models before advanced model choices, and run check_quota before large batches, OpenAI high quality, or 2K/4K generations. check_quota returns storage/rate/service health plus an approximate provider-cost estimate.

Environment Variables

| Variable | Default | Description | | -------------------------- | ------------------------- | ------------------------------- | | GO_BANANAS_API_KEY | — | API-key fallback for STDIO mode | | GO_BANANAS_SERVER_URL | https://gobananasai.com | Server URL | | GO_BANANAS_MCP_TRANSPORT | streamable-http | Transport protocol |

How It Works

This package re-exports the MCP STDIO proxy from gobananas-cli. The proxy bridges STDIO-based MCP clients to the remote Go Bananas server using Streamable HTTP transport. For clients with remote HTTP MCP support, connect directly to https://gobananasai.com/mcp so the client can perform OAuth login and token refresh itself. For STDIO-only clients, run gobananas auth login or gb auth login once; the proxy will use the saved OAuth tokens and refresh them automatically. If you configure both direct HTTP and STDIO under the same name, authenticate the exact entry your client reports in its MCP status.

• Connect timeout: 30 seconds
• Request timeout: 10 minutes (image generation can take 25-55s)

Related

• gobananas-cli — Interactive CLI for Go Bananas
• Go Bananas — AI image generation platform
• Documentation — Full API and tool documentation