gobananas-mcp 1.0.7 → 1.0.8

package/README.md

@@ -1,22 +1,47 @@
 # gobananas-mcp
 
-MCP STDIO proxy for [Go Bananas](https://gobananasai.com) AI image generation. Connects MCP clients (Claude Desktop, Cursor, Claude Code, Codex) to the Go Bananas server.
+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.
 
-This is a thin wrapper around [`gobananas-cli`](https://www.npmjs.com/package/gobananas-cli) that provides the `gobananas-mcp` command for zero-install MCP setup.
+**42 tools** for image generation, conversational editing, character consistency, product marketing, style presets, and analytics — powered by Google Gemini.
 
-## Setup
+## Quick Start
 
-### Claude Code (Recommended)
+### Claude Desktop / claude.ai (Easiest — Remote Connector)
 
-**One-command install** — run this in your terminal:
+No installation needed. Works on desktop, web, and mobile:
+
+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 42 tools are available immediately.
+
+### Claude Code (One Command)
+
+```bash
+claude mcp add go-bananas \
+  -e GO_BANANAS_API_KEY=sk_live_your_api_key \
+  -e GO_BANANAS_SERVER_URL=https://gobananasai.com \
+  -e GO_BANANAS_MCP_TRANSPORT=streamable-http \
+  -- npx -y gobananas-mcp
+```
+
+Add `-s user` to install for all projects.
+
+### Universal Install (9+ Clients)
+
+Works across Claude, Cursor, VS Code, Gemini CLI, and more:
 
 ```bash
-claude mcp add go-bananas -e GO_BANANAS_API_KEY=sk_live_your_api_key_here -e GO_BANANAS_SERVER_URL=https://gobananasai.com -e GO_BANANAS_MCP_TRANSPORT=streamable-http -- npx -y gobananas-mcp
+npx add-mcp https://gobananasai.com/mcp
 ```
 
-### Claude Desktop
+### Claude Desktop (Local STDIO)
 
-Add to `claude_desktop_config.json`:
+If you prefer a local proxy instead of the remote connector, add to your config file:
+
+- **macOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- **Windows**: `%APPDATA%\Claude\claude_desktop_config.json`
 
 ```json
 {
@@ -25,7 +50,7 @@ Add to `claude_desktop_config.json`:
       "command": "npx",
       "args": ["-y", "gobananas-mcp"],
       "env": {
-        "GO_BANANAS_API_KEY": "sk_live_your_api_key_here",
+        "GO_BANANAS_API_KEY": "sk_live_your_api_key",
         "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
         "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
       }
@@ -34,6 +59,8 @@ Add to `claude_desktop_config.json`:
 }
 ```
 
+Restart Claude Desktop after saving.
+
 ### Cursor
 
 Add to `.cursor/mcp.json`:
@@ -45,7 +72,7 @@ Add to `.cursor/mcp.json`:
       "command": "npx",
       "args": ["-y", "gobananas-mcp"],
       "env": {
-        "GO_BANANAS_API_KEY": "sk_live_your_api_key_here",
+        "GO_BANANAS_API_KEY": "sk_live_your_api_key",
         "GO_BANANAS_SERVER_URL": "https://gobananasai.com",
         "GO_BANANAS_MCP_TRANSPORT": "streamable-http"
       }
@@ -54,19 +81,36 @@ Add to `.cursor/mcp.json`:
 }
 ```
 
-You can also pass the API key as a CLI argument: `npx gobananas-mcp --api-key sk_live_your_api_key_here`
+### Global Install
+
+```bash
+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 |
+| **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 |
+| **Analytics** | `check_quota`, `get_usage_stats` | Usage tracking and quota management |
 
 ## Environment Variables
 
 | Variable | Default | Description |
 |----------|---------|-------------|
-| `GO_BANANAS_API_KEY` | — | Your API key (required) |
+| `GO_BANANAS_API_KEY` | — | Your API key (required 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.
+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.
 
 - **Connect timeout**: 30 seconds
 - **Request timeout**: 10 minutes (image generation can take 25-55s)
@@ -75,3 +119,4 @@ This package re-exports the MCP STDIO proxy from `gobananas-cli`. The proxy brid
 
 - [`gobananas-cli`](https://www.npmjs.com/package/gobananas-cli) — Interactive CLI for Go Bananas
 - [Go Bananas](https://gobananasai.com) — AI image generation platform
+- [Documentation](https://docs.gobananasai.com) — Full API and tool documentation

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gobananas-mcp",
-  "version": "1.0.7",
-  "description": "MCP server for Go Bananas AI image generation — use with Claude Desktop, Cursor, Claude Code, Codex",
+  "version": "1.0.8",
+  "description": "MCP server for Go Bananas AI image generation — use with Claude Desktop, claude.ai, Cursor, Claude Code, VS Code, Codex",
   "type": "module",
   "bin": {
     "gobananas-mcp": "./bin/gobananas-mcp.js"
@@ -11,14 +11,20 @@
   ],
   "keywords": [
     "mcp",
+    "mcp-server",
+    "model-context-protocol",
     "ai",
     "image-generation",
     "claude-desktop",
+    "claude",
     "cursor",
     "claude-code",
     "codex",
+    "vscode",
     "gemini",
-    "go-bananas"
+    "go-bananas",
+    "gobananas",
+    "connector"
   ],
   "author": "",
   "license": "MIT",