@chrischall/gemini-mcp 0.2.0 → 0.4.0

package/dist/tools/shared.js

@@ -3,8 +3,8 @@ import { textResult } from '@chrischall/mcp-utils';
 import { writeImage, resolveOutputDir } from '../images.js';
 /** Supported output aspect ratios (Gemini image API). */
 export const ASPECT_RATIOS = ['1:1', '2:3', '3:2', '3:4', '4:3', '4:5', '5:4', '9:16', '16:9', '21:9', '1:4', '4:1', '1:8', '8:1'];
-/** Supported output resolutions. */
-export const IMAGE_SIZES = ['1K', '2K', '4K'];
+/** Supported output resolutions. `512` is Flash-only (0.5K); `1K`/`2K`/`4K` work on all image models. */
+export const IMAGE_SIZES = ['512', '1K', '2K', '4K'];
 /**
  * The model/aspect/size/output fields every generation tool shares. Defined once
  * here so descriptions can't drift between `generate.ts` and `set.ts`. Spread
@@ -13,23 +13,49 @@ export const IMAGE_SIZES = ['1K', '2K', '4K'];
 export const sharedImageSchema = {
     model: z.string().optional().describe('Model id override (default: server default; see gemini_list_models)'),
     aspect_ratio: z.enum(ASPECT_RATIOS).optional().describe('Output aspect ratio'),
-    image_size: z.enum(IMAGE_SIZES).optional().describe('Output resolution'),
+    image_size: z.enum(IMAGE_SIZES).optional().describe('Output resolution (512 = 0.5K, Flash-only)'),
     output_dir: z.string().optional().describe('Directory to write images to (default: $GEMINI_OUTPUT_DIR or cwd)'),
     inline: z.boolean().optional().describe('Return base64 images inline instead of writing to disk'),
+    seed: z.number().int().optional().describe('Seed for reproducible generation; random if omitted'),
+    thinking_level: z.enum(['minimal', 'high']).optional().describe('Reasoning depth (Gemini 3 models); higher can help complex/structural edits'),
+    google_search: z.boolean().optional().describe('Ground the image in live Google Search results (current events, weather, data)'),
+    from_clipboard: z.boolean().optional().describe('Use the image currently on the macOS system clipboard as an input (downscaled to JPEG)'),
 };
+/**
+ * Return the provided seed, or pick a random one. Capped well below INT32_MAX
+ * so derived per-image seeds (`seed + i`) can't overflow a 32-bit int.
+ */
+export function pickSeed(seed) {
+    return seed ?? Math.floor(Math.random() * 2_147_483_000);
+}
+/** Build the result metadata echoed to the caller (omitting unset optionals). */
+export function buildMeta(model, seed, opts) {
+    const meta = { model, seed };
+    if (opts.aspect_ratio)
+        meta.aspect_ratio = opts.aspect_ratio;
+    if (opts.image_size)
+        meta.image_size = opts.image_size;
+    return meta;
+}
 /**
  * Either return images inline (base64 content blocks) or write them to disk and
  * return their paths as a text result. `inline` wins when true.
+ * Optional `meta` is merged into the disk-path JSON result, or prepended as a
+ * text block in inline mode (only if meta has keys).
  */
-export async function emit(named, opts) {
+export async function emit(named, opts, meta) {
     if (opts.inline) {
-        return {
-            content: named.map((n) => ({ type: 'image', data: n.image.base64, mimeType: n.image.mimeType })),
-        };
+        const imageBlocks = named.map((n) => ({ type: 'image', data: n.image.base64, mimeType: n.image.mimeType }));
+        if (meta && Object.keys(meta).length > 0) {
+            return {
+                content: [{ type: 'text', text: JSON.stringify(meta, null, 2) }, ...imageBlocks],
+            };
+        }
+        return { content: imageBlocks };
     }
     const dir = resolveOutputDir(opts.output_dir);
     const images = [];
     for (const n of named)
         images.push(await writeImage(dir, n.base, n.image.base64, n.image.mimeType));
-    return textResult({ images });
+    return textResult({ images, ...meta });
 }

package/dist/version.js

@@ -1,2 +1,2 @@
 /** Single source of the server version. release-please bumps the literal below. */
-export const VERSION = '0.2.0'; // x-release-please-version
+export const VERSION = '0.4.0'; // x-release-please-version

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chrischall/gemini-mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "mcpName": "io.github.chrischall/gemini-mcp",
   "description": "Gemini image-generation MCP server for Claude — developed and maintained by AI (Claude Code)",
   "author": "Claude Code (AI) <https://www.anthropic.com/claude>",

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/chrischall/gemini-mcp",
     "source": "github"
   },
-  "version": "0.2.0",
+  "version": "0.4.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@chrischall/gemini-mcp",
-      "version": "0.2.0",
+      "version": "0.4.0",
       "transport": {
         "type": "stdio"
       },
@@ -36,6 +36,13 @@
           "isRequired": false,
           "format": "string",
           "isSecret": false
+        },
+        {
+          "name": "GEMINI_INPUT_DIR",
+          "description": "Directory to resolve bare input-image filenames against",
+          "isRequired": false,
+          "format": "string",
+          "isSecret": false
         }
       ]
     }