gobananas-mcp 1.0.8 → 1.0.10

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (2) hide show
  1. package/README.md +77 -26
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -2,7 +2,12 @@
2
2
 
3
3
  MCP server for [Go Bananas](https://gobananasai.com) AI image generation. Connects MCP clients (Claude Desktop, Claude Code, Cursor, VS Code, Codex) to the Go Bananas server.
4
4
 
5
- **42 tools** for image generation, conversational editing, character consistency, product marketing, style presets, and analytics — powered by Google Gemini.
5
+ **45 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.
6
+
7
+ ## What's New (v1.0.7)
8
+
9
+ - **Prompt Optimization**: New `enhance_prompt` parameter enriches short prompts with AI-powered visual details (lighting, composition, style) before generation
10
+ - **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.
6
11
 
7
12
  ## Quick Start
8
13
 
@@ -14,20 +19,21 @@ No installation needed. Works on desktop, web, and mobile:
14
19
  2. Enter URL: `https://gobananasai.com/mcp`
15
20
  3. Authenticate with your Go Bananas account
16
21
 
17
- That's it. All 42 tools are available immediately.
22
+ That's it. All 45 tools are available immediately.
18
23
 
19
- ### Claude Code (One Command)
24
+ ### Claude Code (Recommended — Remote HTTP OAuth)
20
25
 
21
26
  ```bash
22
27
  claude mcp add go-bananas \
23
- -e GO_BANANAS_API_KEY=sk_live_your_api_key \
24
- -e GO_BANANAS_SERVER_URL=https://gobananasai.com \
25
- -e GO_BANANAS_MCP_TRANSPORT=streamable-http \
26
- -- npx -y gobananas-mcp
28
+ --transport http \
29
+ https://gobananasai.com/mcp
27
30
  ```
28
31
 
29
32
  Add `-s user` to install for all projects.
30
33
 
34
+ Then run `/mcp` in Claude Code and authenticate in the browser. This uses Go Bananas OAuth;
35
+ you do not need to paste an API key into your MCP config.
36
+
31
37
  ### Universal Install (9+ Clients)
32
38
 
33
39
  Works across Claude, Cursor, VS Code, Gemini CLI, and more:
@@ -36,9 +42,20 @@ Works across Claude, Cursor, VS Code, Gemini CLI, and more:
36
42
  npx add-mcp https://gobananasai.com/mcp
37
43
  ```
38
44
 
39
- ### Claude Desktop (Local STDIO)
45
+ ### STDIO Clients / Hermes / Cloud Agents
46
+
47
+ If your client cannot use remote HTTP MCP connectors, use the local STDIO proxy.
48
+ Run browser login once, then point the client at `gobananas-mcp` without putting an
49
+ API key in the MCP config:
50
+
51
+ ```bash
52
+ npx -y gobananas-cli auth login
53
+ ```
54
+
55
+ This opens Go Bananas in your browser, stores OAuth tokens locally, and the STDIO
56
+ proxy automatically sends/refreshes bearer tokens when connecting upstream.
40
57
 
41
- If you prefer a local proxy instead of the remote connector, add to your config file:
58
+ Then add the proxy to your MCP config.
42
59
 
43
60
  - **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
44
61
  - **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
@@ -50,7 +67,6 @@ If you prefer a local proxy instead of the remote connector, add to your config
50
67
  "command": "npx",
51
68
  "args": ["-y", "gobananas-mcp"],
52
69
  "env": {
53
- "GO_BANANAS_API_KEY": "sk_live_your_api_key",
54
70
  "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
55
71
  "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
56
72
  }
@@ -61,9 +77,43 @@ If you prefer a local proxy instead of the remote connector, add to your config
61
77
 
62
78
  Restart Claude Desktop after saving.
63
79
 
80
+ For headless/cloud environments, run `npx -y gobananas-cli auth login --no-open`
81
+ and open the printed authorization URL in a browser that can reach the local
82
+ callback address. If that is not possible, use the API-key fallback:
83
+
84
+ ```json
85
+ {
86
+ "mcpServers": {
87
+ "go-bananas": {
88
+ "command": "npx",
89
+ "args": ["-y", "gobananas-mcp"],
90
+ "env": {
91
+ "GO_BANANAS_API_KEY": "sk_live_your_api_key",
92
+ "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
93
+ "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
94
+ }
95
+ }
96
+ }
97
+ }
98
+ ```
99
+
64
100
  ### Cursor
65
101
 
66
- Add to `.cursor/mcp.json`:
102
+ Prefer remote HTTP OAuth when supported:
103
+
104
+ ```json
105
+ {
106
+ "mcpServers": {
107
+ "go-bananas": {
108
+ "type": "http",
109
+ "url": "https://gobananasai.com/mcp"
110
+ }
111
+ }
112
+ }
113
+ ```
114
+
115
+ Otherwise add the STDIO proxy to `.cursor/mcp.json` after running
116
+ `npx -y gobananas-cli auth login`:
67
117
 
68
118
  ```json
69
119
  {
@@ -72,7 +122,6 @@ Add to `.cursor/mcp.json`:
72
122
  "command": "npx",
73
123
  "args": ["-y", "gobananas-mcp"],
74
124
  "env": {
75
- "GO_BANANAS_API_KEY": "sk_live_your_api_key",
76
125
  "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
77
126
  "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
78
127
  }
@@ -91,26 +140,28 @@ Then use `"command": "gobananas-mcp"` without the `args` field.
91
140
 
92
141
  ## What You Can Do
93
142
 
94
- | Category | Tools | Examples |
95
- |----------|-------|---------|
96
- | **Generate** | `generate_image`, `batch_generate` | Create images from text prompts |
97
- | **Edit** | `edit_image`, `continue_editing` | "add clouds", "make it brighter" |
98
- | **Characters** | `create_character`, `generate_with_character` | Consistent characters across scenes |
99
- | **Products** | `create_product_reference`, `generate_with_product` | Marketing images with real products |
100
- | **Styles** | `create_style_preset`, `list_style_presets` | Reusable brand templates |
101
- | **Analytics** | `check_quota`, `get_usage_stats` | Usage tracking and quota management |
143
+ | Category | Tools | Examples |
144
+ | ---------------------- | --------------------------------------------------- | ------------------------------------------------------------------------------ |
145
+ | **Generate** | `generate_image`, `batch_generate` | Create images from text prompts (use `enhance_prompt` for AI-enhanced results) |
146
+ | **Edit** | `edit_image`, `continue_editing` | "add clouds", "make it brighter" |
147
+ | **Characters** | `create_character`, `generate_with_character` | Consistent characters across scenes |
148
+ | **Products** | `create_product_reference`, `generate_with_product` | Marketing images with real products |
149
+ | **Styles** | `create_style_preset`, `list_style_presets` | Reusable brand templates |
150
+ | **Models & Analytics** | `list_models`, `check_quota`, `get_usage_stats` | Capability discovery, cost estimates, quota tracking |
151
+
152
+ 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.
102
153
 
103
154
  ## Environment Variables
104
155
 
105
- | Variable | Default | Description |
106
- |----------|---------|-------------|
107
- | `GO_BANANAS_API_KEY` | — | Your API key (required for STDIO mode) |
108
- | `GO_BANANAS_SERVER_URL` | `https://gobananasai.com` | Server URL |
109
- | `GO_BANANAS_MCP_TRANSPORT` | `streamable-http` | Transport protocol |
156
+ | Variable | Default | Description |
157
+ | -------------------------- | ------------------------- | ------------------------------- |
158
+ | `GO_BANANAS_API_KEY` | — | API-key fallback for STDIO mode |
159
+ | `GO_BANANAS_SERVER_URL` | `https://gobananasai.com` | Server URL |
160
+ | `GO_BANANAS_MCP_TRANSPORT` | `streamable-http` | Transport protocol |
110
161
 
111
162
  ## How It Works
112
163
 
113
- This package re-exports the MCP STDIO proxy from [`gobananas-cli`](https://www.npmjs.com/package/gobananas-cli). The proxy bridges STDIO-based MCP clients to the remote Go Bananas server using Streamable HTTP transport.
164
+ This package re-exports the MCP STDIO proxy from [`gobananas-cli`](https://www.npmjs.com/package/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.
114
165
 
115
166
  - **Connect timeout**: 30 seconds
116
167
  - **Request timeout**: 10 minutes (image generation can take 25-55s)
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "gobananas-mcp",
3
- "version": "1.0.8",
3
+ "version": "1.0.10",
4
4
  "description": "MCP server for Go Bananas AI image generation — use with Claude Desktop, claude.ai, Cursor, Claude Code, VS Code, Codex",
5
5
  "type": "module",
6
6
  "bin": {
@@ -35,6 +35,6 @@
35
35
  "node": ">=18.0.0"
36
36
  },
37
37
  "dependencies": {
38
- "gobananas-cli": "^1.0.4"
38
+ "gobananas-cli": "^1.0.9"
39
39
  }
40
40
  }