@chrischall/gemini-mcp 0.3.0 → 0.5.0

package/.claude-plugin/marketplace.json

@@ -7,7 +7,7 @@
   },
   "metadata": {
     "description": "MCP server for Google Gemini image generation and editing — generate and edit images via the Gemini API",
-    "version": "0.3.0"
+    "version": "0.5.0"
   },
   "plugins": [
     {
@@ -15,7 +15,7 @@
       "displayName": "Gemini Images",
       "source": "./",
       "description": "Generate and edit images with Google Gemini image models (Nano Banana / Nano Banana Pro) via natural language prompts",
-      "version": "0.3.0",
+      "version": "0.5.0",
       "author": {
         "name": "Chris Hall"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "gemini-mcp",
   "displayName": "Gemini Images",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "MCP server for Google Gemini image generation and editing — generate and edit images via the Gemini API",
   "author": {
     "name": "Chris Hall",

package/.mcp.json

@@ -6,7 +6,8 @@
       "env": {
         "GEMINI_API_KEY": "${GEMINI_API_KEY}",
         "GEMINI_IMAGE_MODEL": "${GEMINI_IMAGE_MODEL}",
-        "GEMINI_OUTPUT_DIR": "${GEMINI_OUTPUT_DIR}"
+        "GEMINI_OUTPUT_DIR": "${GEMINI_OUTPUT_DIR}",
+        "GEMINI_INPUT_DIR": "${GEMINI_INPUT_DIR}"
       }
     }
   }

package/README.md

@@ -11,6 +11,7 @@ Developed and maintained by AI (Claude Code).
 | `GEMINI_API_KEY` | Yes | Your Google Gemini API key ([aistudio.google.com/apikey](https://aistudio.google.com/apikey)) |
 | `GEMINI_IMAGE_MODEL` | No | Override the default image model (default: `gemini-3-pro-image`) |
 | `GEMINI_OUTPUT_DIR` | No | Default directory for generated images (default: current working directory) |
+| `GEMINI_INPUT_DIR` | No | Directory to resolve bare input-image filenames against (so `images: ["foo.jpg"]` works) |
 
 ## Tools
 

package/SKILL.md

@@ -71,6 +71,7 @@ Note: Image generation requires a billing-enabled Google Cloud project.
 | `GEMINI_API_KEY` | Yes | Your Google Gemini API key |
 | `GEMINI_IMAGE_MODEL` | No | Override the default image model (default: `gemini-3-pro-image`) |
 | `GEMINI_OUTPUT_DIR` | No | Default directory for saved images (default: current working directory) |
+| `GEMINI_INPUT_DIR` | No | Directory to resolve bare input-image filenames against (e.g. point at Cowork's `uploads/` folder so `images: ["house.jpg"]` works) |
 
 ## Tools
 
@@ -129,7 +130,7 @@ gemini_generate_set(
 → returns master + 5 variations
 ```
 
-**Use a reference photo by value (no file needed):**
+**Use a reference photo by value (when you have the bytes):**
 ```
 gemini_edit_image(
   prompt: "place this house on a vintage travel-poster background",
@@ -137,6 +138,8 @@ gemini_edit_image(
 )
 → returns path to the edited image
 ```
+`images_base64` is for bytes you actually have — a file you `Read`/encode, a URL
+you fetch, or a `data:` URI the user pastes as **text**.
 
 **Iterate on ONE image conversationally (multi-turn):**
 ```
@@ -147,7 +150,25 @@ r2 = gemini_interact(input: "add a sleeping cat on the chair",
    → refined image that preserves r1; returns a NEW interaction_id
 ```
 Prefer this over re-running `gemini_edit_image` when you're making a *series* of incremental edits — the model keeps the prior result in context.
-Pasted/attached images aren't written to disk by the host, so pass their bytes via `images_base64` (a `data:` URI or raw base64) instead of a path.
+**⚠️ Chat-pasted/attached images can't be fed to these tools directly.** A pasted
+image reaches the assistant as a *vision* block — the assistant can SEE it but
+never receives the original bytes, and the host doesn't write it to disk. So
+neither `images` (no file exists) nor `images_base64` (the bytes can't be
+reconstructed from a downscaled vision rendering) is obtainable from a paste.
+To use a real reference photo, the **user** must make the bytes available: save
+the file and give its **path** (→ `images`), drop it into the project dir, paste
+it as a **`data:` URI in text**, or host it at a **URL** (fetch → base64 →
+`images_base64`). This is a host/Cowork limitation, not an MCP one.
+
+Two built-in ways to get past the unreachable-paste problem without any manual
+extraction:
+- **`from_clipboard: true`** (macOS) — the tool reads the image off the system
+  clipboard itself (osascript), downscales it, and uses it. The user just needs
+  to **copy** the image (⌘C — distinct from pasting it inline into chat, which
+  doesn't keep it on the clipboard). Works on every image tool:
+  `gemini_edit_image(prompt: "…", from_clipboard: true)`.
+- **`GEMINI_INPUT_DIR`** — point it at a folder (e.g. Cowork's `uploads/`); then a
+  **bare filename** resolves against it: `gemini_edit_image(prompt: "…", images: ["house.jpg"])`.
 
 ## Notes