gobananas-mcp 1.0.10 → 1.0.11

package/README.md

@@ -2,7 +2,7 @@
 
 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.
 
-**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.
+**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)
 
@@ -11,29 +11,47 @@ MCP server for [Go Bananas](https://gobananasai.com) AI image generation. Connec
 
 ## Quick Start
 
-### Claude Desktop / claude.ai (Easiest — Remote Connector)
+### Auth Modes
 
-No installation needed. Works on desktop, web, and mobile:
+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 45 tools are available immediately.
+That's it. All 47 tools are available immediately.
 
 ### Claude Code (Recommended — Remote HTTP OAuth)
 
 ```bash
-claude mcp add go-bananas \
-  --transport http \
-  https://gobananasai.com/mcp
+claude mcp add --transport http -s user go-bananas https://gobananasai.com/mcp
 ```
 
-Add `-s user` to install for all projects.
-
 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)
+
+```bash
+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:
@@ -44,7 +62,7 @@ npx add-mcp https://gobananasai.com/mcp
 
 ### STDIO Clients / Hermes / Cloud Agents
 
-If your client cannot use remote HTTP MCP connectors, use the local STDIO proxy.
+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:
 
@@ -77,6 +95,24 @@ Then add the proxy to your MCP config.
 
 Restart Claude Desktop after saving.
 
+For Claude Code STDIO:
+
+```bash
+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:
+
+```bash
+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:
@@ -161,7 +197,7 @@ Run `list_models` before advanced model choices, and run `check_quota` before la
 
 ## How It Works
 
-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.
+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. 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)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "gobananas-mcp",
-  "version": "1.0.10",
+  "version": "1.0.11",
   "description": "MCP server for Go Bananas AI image generation — use with Claude Desktop, claude.ai, Cursor, Claude Code, VS Code, Codex",
   "type": "module",
   "bin": {
@@ -35,6 +35,6 @@
     "node": ">=18.0.0"
   },
   "dependencies": {
-    "gobananas-cli": "^1.0.9"
+    "gobananas-cli": "^1.0.10"
   }
 }