@saroby/nanobanana-mcp 1.0.1

package/README.md

@@ -0,0 +1,60 @@
+# @saroby/nanobanana-mcp
+
+Google Gemini image generation MCP server (Nano Banana).
+
+## Features
+
+- **generate_image** - Generate images using Google Gemini models
+  - `flash` mode: gemini-2.0-flash-exp (fast, ~2-3s)
+  - `pro` mode: imagen-3.0-generate-002 (high quality, ~5-8s)
+- **list_images** - List generated images in a directory
+
+## Setup
+
+### Get API Key
+
+1. Go to [Google AI Studio](https://aistudio.google.com/apikey)
+2. Create an API key
+
+### Install in Claude Code
+
+```bash
+claude mcp add nanobanana -e GEMINI_API_KEY=your-key-here -- npx -y @saroby/nanobanana-mcp
+```
+
+### Manual Usage
+
+```bash
+GEMINI_API_KEY=your-key-here npx @saroby/nanobanana-mcp
+```
+
+## Tools
+
+### generate_image
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `prompt` | string | Yes | Image description (1-8192 chars) |
+| `model` | `"flash"` \| `"pro"` | No | Model selection (default: flash) |
+| `aspect_ratio` | enum | No | `1:1`, `16:9`, `9:16`, `4:3`, `3:4` |
+| `negative_prompt` | string | No | Elements to exclude |
+| `output_dir` | string | No | Save directory (default: ./nanobanana-images) |
+| `count` | number | No | Number of images 1-4 (default: 1) |
+
+### list_images
+
+| Parameter | Type | Required | Description |
+|-----------|------|----------|-------------|
+| `directory` | string | No | Directory to search (default: ./nanobanana-images) |
+
+## Development
+
+```bash
+npm install
+npm run build
+npm run dev  # watch mode
+```
+
+## License
+
+MIT

package/dist/gemini.d.ts

@@ -0,0 +1,14 @@
+import { type ModelType, type AspectRatio } from "./utils/config.js";
+export interface GenerateImageOptions {
+    prompt: string;
+    model?: ModelType;
+    aspectRatio?: AspectRatio;
+    negativePrompt?: string;
+    count?: number;
+}
+export interface GeneratedImage {
+    base64Data: string;
+    mimeType: string;
+}
+export declare function generateImages(options: GenerateImageOptions): Promise<GeneratedImage[]>;
+//# sourceMappingURL=gemini.d.ts.map

package/dist/gemini.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.d.ts","sourceRoot":"","sources":["../src/gemini.ts"],"names":[],"mappings":"AACA,OAAO,EAAqB,KAAK,SAAS,EAAE,KAAK,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAExF,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;IAClB,WAAW,CAAC,EAAE,WAAW,CAAC;IAC1B,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,cAAc,CAClC,OAAO,EAAE,oBAAoB,GAC5B,OAAO,CAAC,cAAc,EAAE,CAAC,CAkB3B"}

package/dist/gemini.js

@@ -0,0 +1,46 @@
+import { GoogleGenAI } from "@google/genai";
+import { getApiKey, MODELS } from "./utils/config.js";
+export async function generateImages(options) {
+    const apiKey = getApiKey();
+    const genai = new GoogleGenAI({ apiKey });
+    const model = options.model || "flash";
+    const modelId = MODELS[model];
+    const count = options.count || 1;
+    const images = [];
+    for (let i = 0; i < count; i++) {
+        const image = await generateWithGemini(genai, modelId, options);
+        if (image) {
+            images.push(image);
+        }
+    }
+    return images;
+}
+async function generateWithGemini(genai, modelId, options) {
+    let promptText = options.prompt;
+    if (options.negativePrompt) {
+        promptText += `\n\nAvoid: ${options.negativePrompt}`;
+    }
+    if (options.aspectRatio && options.aspectRatio !== "1:1") {
+        promptText += `\n\nAspect ratio: ${options.aspectRatio}`;
+    }
+    const response = await genai.models.generateContent({
+        model: modelId,
+        contents: [{ role: "user", parts: [{ text: promptText }] }],
+        config: {
+            responseModalities: ["image", "text"],
+        },
+    });
+    const parts = response.candidates?.[0]?.content?.parts;
+    if (!parts)
+        return null;
+    for (const part of parts) {
+        if (part.inlineData?.data && part.inlineData.mimeType?.startsWith("image/")) {
+            return {
+                base64Data: part.inlineData.data,
+                mimeType: part.inlineData.mimeType,
+            };
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=gemini.js.map

package/dist/gemini.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gemini.js","sourceRoot":"","sources":["../src/gemini.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,EAAoC,MAAM,mBAAmB,CAAC;AAexF,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,OAA6B;IAE7B,MAAM,MAAM,GAAG,SAAS,EAAE,CAAC;IAC3B,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;IAE1C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,OAAO,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC9B,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC;IAEjC,MAAM,MAAM,GAAqB,EAAE,CAAC;IAEpC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE,EAAE,CAAC;QAC/B,MAAM,KAAK,GAAG,MAAM,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,CAAC;QAChE,IAAI,KAAK,EAAE,CAAC;YACV,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,KAAK,UAAU,kBAAkB,CAC/B,KAAkB,EAClB,OAAe,EACf,OAA6B;IAE7B,IAAI,UAAU,GAAG,OAAO,CAAC,MAAM,CAAC;IAChC,IAAI,OAAO,CAAC,cAAc,EAAE,CAAC;QAC3B,UAAU,IAAI,cAAc,OAAO,CAAC,cAAc,EAAE,CAAC;IACvD,CAAC;IACD,IAAI,OAAO,CAAC,WAAW,IAAI,OAAO,CAAC,WAAW,KAAK,KAAK,EAAE,CAAC;QACzD,UAAU,IAAI,qBAAqB,OAAO,CAAC,WAAW,EAAE,CAAC;IAC3D,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,MAAM,CAAC,eAAe,CAAC;QAClD,KAAK,EAAE,OAAO;QACd,QAAQ,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,EAAE,CAAC;QAC3D,MAAM,EAAE;YACN,kBAAkB,EAAE,CAAC,OAAO,EAAE,MAAM,CAAC;SACtC;KACF,CAAC,CAAC;IAEH,MAAM,KAAK,GAAG,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC;IACvD,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,IAAI,IAAI,CAAC,UAAU,EAAE,IAAI,IAAI,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC5E,OAAO;gBACL,UAAU,EAAE,IAAI,CAAC,UAAU,CAAC,IAAI;gBAChC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,QAAQ;aACnC,CAAC;QACJ,CAAC;IACH,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { registerGenerateImageTool } from "./tools/generate-image.js";
+import { registerListImagesTool } from "./tools/list-images.js";
+const server = new McpServer({
+    name: "nanobanana-mcp",
+    version: "1.0.0",
+});
+registerGenerateImageTool(server);
+registerListImagesTool(server);
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("nanobanana-mcp server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC;AACtE,OAAO,EAAE,sBAAsB,EAAE,MAAM,wBAAwB,CAAC;AAEhE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,gBAAgB;IACtB,OAAO,EAAE,OAAO;CACjB,CAAC,CAAC;AAEH,yBAAyB,CAAC,MAAM,CAAC,CAAC;AAClC,sBAAsB,CAAC,MAAM,CAAC,CAAC;AAE/B,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,wCAAwC,CAAC,CAAC;AAC1D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/tools/generate-image.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerGenerateImageTool(server: McpServer): void;
+//# sourceMappingURL=generate-image.d.ts.map

package/dist/tools/generate-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.d.ts","sourceRoot":"","sources":["../../src/tools/generate-image.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAuCzE,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6DjE"}

package/dist/tools/generate-image.js

@@ -0,0 +1,85 @@
+import { z } from "zod";
+import { generateImages } from "../gemini.js";
+import { resolveOutputDir, ASPECT_RATIOS } from "../utils/config.js";
+import { saveBase64Image } from "../utils/file.js";
+const GenerateImageSchema = {
+    prompt: z
+        .string()
+        .min(1)
+        .max(8192)
+        .describe("Image description prompt (1-8192 characters)"),
+    model: z
+        .enum(["flash", "pro"])
+        .optional()
+        .default("flash")
+        .describe("Model to use: 'flash' (fast, gemini-2.0-flash-exp) or 'pro' (high quality, imagen-3.0)"),
+    aspect_ratio: z
+        .enum(ASPECT_RATIOS)
+        .optional()
+        .default("1:1")
+        .describe("Image aspect ratio"),
+    negative_prompt: z
+        .string()
+        .optional()
+        .describe("Elements to exclude from the image"),
+    output_dir: z
+        .string()
+        .optional()
+        .describe("Output directory path (default: ./nanobanana-images)"),
+    count: z
+        .number()
+        .int()
+        .min(1)
+        .max(4)
+        .optional()
+        .default(1)
+        .describe("Number of images to generate (1-4)"),
+};
+export function registerGenerateImageTool(server) {
+    server.tool("generate_image", "Generate images using Google Gemini models. Supports 'flash' (fast, gemini-2.0-flash-exp) and 'pro' (high quality, imagen-3.0) models.", GenerateImageSchema, async (params) => {
+        try {
+            const outputDir = resolveOutputDir(params.output_dir);
+            const images = await generateImages({
+                prompt: params.prompt,
+                model: params.model,
+                aspectRatio: params.aspect_ratio,
+                negativePrompt: params.negative_prompt,
+                count: params.count,
+            });
+            if (images.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: "No images were generated. Try a different prompt or model.",
+                        },
+                    ],
+                };
+            }
+            const savedPaths = [];
+            const contentItems = [];
+            for (const image of images) {
+                const filePath = saveBase64Image(image.base64Data, outputDir);
+                savedPaths.push(filePath);
+                contentItems.push({
+                    type: "image",
+                    data: image.base64Data,
+                    mimeType: image.mimeType,
+                });
+            }
+            contentItems.unshift({
+                type: "text",
+                text: `Generated ${images.length} image(s):\n${savedPaths.map((p, i) => `${i + 1}. ${p}`).join("\n")}\n\nModel: ${params.model || "flash"}\nPrompt: ${params.prompt}${params.negative_prompt ? `\nNegative: ${params.negative_prompt}` : ""}`,
+            });
+            return { content: contentItems };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error generating image: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=generate-image.js.map

package/dist/tools/generate-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-image.js","sourceRoot":"","sources":["../../src/tools/generate-image.ts"],"names":[],"mappings":"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"}

package/dist/tools/list-images.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerListImagesTool(server: McpServer): void;
+//# sourceMappingURL=list-images.d.ts.map

package/dist/tools/list-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-images.d.ts","sourceRoot":"","sources":["../../src/tools/list-images.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAWzE,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA8C9D"}

package/dist/tools/list-images.js

@@ -0,0 +1,49 @@
+import { z } from "zod";
+import { resolveOutputDir } from "../utils/config.js";
+import { listImageFiles } from "../utils/file.js";
+const ListImagesSchema = {
+    directory: z
+        .string()
+        .optional()
+        .describe("Directory to search for images (default: ./nanobanana-images)"),
+};
+export function registerListImagesTool(server) {
+    server.tool("list_images", "List generated images in the specified directory.", ListImagesSchema, async (params) => {
+        try {
+            const dir = resolveOutputDir(params.directory);
+            const files = listImageFiles(dir);
+            if (files.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No images found in: ${dir}`,
+                        },
+                    ],
+                };
+            }
+            const fileList = files
+                .map((f) => {
+                const sizeKB = (f.size / 1024).toFixed(1);
+                return `- ${f.name} (${sizeKB} KB, ${f.createdAt})`;
+            })
+                .join("\n");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Found ${files.length} image(s) in ${dir}:\n\n${fileList}`,
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: "text", text: `Error listing images: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=list-images.js.map

package/dist/tools/list-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list-images.js","sourceRoot":"","sources":["../../src/tools/list-images.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAElD,MAAM,gBAAgB,GAAG;IACvB,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,+DAA+D,CAAC;CAC7E,CAAC;AAEF,MAAM,UAAU,sBAAsB,CAAC,MAAiB;IACtD,MAAM,CAAC,IAAI,CACT,aAAa,EACb,mDAAmD,EACnD,gBAAgB,EAChB,KAAK,EAAE,MAAM,EAAE,EAAE;QACf,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,gBAAgB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YAC/C,MAAM,KAAK,GAAG,cAAc,CAAC,GAAG,CAAC,CAAC;YAElC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,uBAAuB,GAAG,EAAE;yBACnC;qBACF;iBACF,CAAC;YACJ,CAAC;YAED,MAAM,QAAQ,GAAG,KAAK;iBACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBACT,MAAM,MAAM,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC1C,OAAO,KAAK,CAAC,CAAC,IAAI,KAAK,MAAM,QAAQ,CAAC,CAAC,SAAS,GAAG,CAAC;YACtD,CAAC,CAAC;iBACD,IAAI,CAAC,IAAI,CAAC,CAAC;YAEd,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,SAAS,KAAK,CAAC,MAAM,gBAAgB,GAAG,QAAQ,QAAQ,EAAE;qBACjE;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,OAAO,GACX,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YACzD,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,yBAAyB,OAAO,EAAE,EAAE,CAAC;gBACrE,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/utils/config.d.ts

@@ -0,0 +1,11 @@
+export declare function getApiKey(): string;
+export declare const DEFAULT_OUTPUT_DIR: string;
+export declare const MODELS: {
+    readonly flash: "gemini-3-flash-preview";
+    readonly pro: "gemini-3-pro-preview";
+};
+export type ModelType = keyof typeof MODELS;
+export declare const ASPECT_RATIOS: readonly ["1:1", "16:9", "9:16", "4:3", "3:4"];
+export type AspectRatio = (typeof ASPECT_RATIOS)[number];
+export declare function resolveOutputDir(outputDir?: string): string;
+//# sourceMappingURL=config.d.ts.map

package/dist/utils/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAEA,wBAAgB,SAAS,IAAI,MAAM,CASlC;AAED,eAAO,MAAM,kBAAkB,QAAwD,CAAC;AAExF,eAAO,MAAM,MAAM;;;CAGT,CAAC;AAEX,MAAM,MAAM,SAAS,GAAG,MAAM,OAAO,MAAM,CAAC;AAE5C,eAAO,MAAM,aAAa,gDAAiD,CAAC;AAC5E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,wBAAgB,gBAAgB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3D"}

package/dist/utils/config.js

@@ -0,0 +1,20 @@
+import path from "node:path";
+export function getApiKey() {
+    const key = process.env.GEMINI_API_KEY || process.env.GOOGLE_API_KEY;
+    if (!key) {
+        throw new Error("API key not found. Set GEMINI_API_KEY or GOOGLE_API_KEY environment variable.\n" +
+            "Get your key at: https://aistudio.google.com/apikey");
+    }
+    return key;
+}
+export const DEFAULT_OUTPUT_DIR = process.env.IMAGE_OUTPUT_DIR || "./nanobanana-images";
+export const MODELS = {
+    flash: "gemini-3-flash-preview",
+    pro: "gemini-3-pro-preview",
+};
+export const ASPECT_RATIOS = ["1:1", "16:9", "9:16", "4:3", "3:4"];
+export function resolveOutputDir(outputDir) {
+    const dir = outputDir || DEFAULT_OUTPUT_DIR;
+    return path.isAbsolute(dir) ? dir : path.resolve(process.cwd(), dir);
+}
+//# sourceMappingURL=config.js.map

package/dist/utils/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/utils/config.ts"],"names":[],"mappings":"AAAA,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC;IACrE,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iFAAiF;YAC/E,qDAAqD,CACxD,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,qBAAqB,CAAC;AAExF,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,KAAK,EAAE,wBAAwB;IAC/B,GAAG,EAAE,sBAAsB;CACnB,CAAC;AAIX,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,CAAU,CAAC;AAG5E,MAAM,UAAU,gBAAgB,CAAC,SAAkB;IACjD,MAAM,GAAG,GAAG,SAAS,IAAI,kBAAkB,CAAC;IAC5C,OAAO,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;AACvE,CAAC"}

package/dist/utils/file.d.ts

@@ -0,0 +1,11 @@
+export declare function ensureDir(dirPath: string): void;
+export declare function generateFileName(prefix?: string): string;
+export declare function saveBase64Image(base64Data: string, outputDir: string, fileName?: string): string;
+export interface ImageFileInfo {
+    name: string;
+    path: string;
+    size: number;
+    createdAt: string;
+}
+export declare function listImageFiles(dirPath: string): ImageFileInfo[];
+//# sourceMappingURL=file.d.ts.map

package/dist/utils/file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.d.ts","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAGA,wBAAgB,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAI/C;AAED,wBAAgB,gBAAgB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAIxD;AAED,wBAAgB,eAAe,CAC7B,UAAU,EAAE,MAAM,EAClB,SAAS,EAAE,MAAM,EACjB,QAAQ,CAAC,EAAE,MAAM,GAChB,MAAM,CAOR;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,MAAM,GAAG,aAAa,EAAE,CAyB/D"}

package/dist/utils/file.js

@@ -0,0 +1,42 @@
+import fs from "node:fs";
+import path from "node:path";
+export function ensureDir(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        fs.mkdirSync(dirPath, { recursive: true });
+    }
+}
+export function generateFileName(prefix) {
+    const timestamp = new Date().toISOString().replace(/[:.]/g, "-");
+    const rand = Math.random().toString(36).substring(2, 8);
+    return `${prefix ? prefix + "-" : ""}${timestamp}-${rand}.png`;
+}
+export function saveBase64Image(base64Data, outputDir, fileName) {
+    ensureDir(outputDir);
+    const name = fileName || generateFileName("nanobanana");
+    const filePath = path.join(outputDir, name);
+    const buffer = Buffer.from(base64Data, "base64");
+    fs.writeFileSync(filePath, buffer);
+    return filePath;
+}
+export function listImageFiles(dirPath) {
+    if (!fs.existsSync(dirPath)) {
+        return [];
+    }
+    const entries = fs.readdirSync(dirPath, { withFileTypes: true });
+    const imageExtensions = new Set([".png", ".jpg", ".jpeg", ".webp", ".gif"]);
+    return entries
+        .filter((entry) => entry.isFile() &&
+        imageExtensions.has(path.extname(entry.name).toLowerCase()))
+        .map((entry) => {
+        const fullPath = path.join(dirPath, entry.name);
+        const stat = fs.statSync(fullPath);
+        return {
+            name: entry.name,
+            path: fullPath,
+            size: stat.size,
+            createdAt: stat.birthtime.toISOString(),
+        };
+    })
+        .sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+//# sourceMappingURL=file.js.map

package/dist/utils/file.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file.js","sourceRoot":"","sources":["../../src/utils/file.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,MAAM,UAAU,SAAS,CAAC,OAAe;IACvC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,EAAE,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED,MAAM,UAAU,gBAAgB,CAAC,MAAe;IAC9C,MAAM,SAAS,GAAG,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACxD,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,IAAI,IAAI,MAAM,CAAC;AACjE,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,UAAkB,EAClB,SAAiB,EACjB,QAAiB;IAEjB,SAAS,CAAC,SAAS,CAAC,CAAC;IACrB,MAAM,IAAI,GAAG,QAAQ,IAAI,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC;IACjD,EAAE,CAAC,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACnC,OAAO,QAAQ,CAAC;AAClB,CAAC;AASD,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QAC5B,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,MAAM,OAAO,GAAG,EAAE,CAAC,WAAW,CAAC,OAAO,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC;IAE5E,OAAO,OAAO;SACX,MAAM,CACL,CAAC,KAAK,EAAE,EAAE,CACR,KAAK,CAAC,MAAM,EAAE;QACd,eAAe,CAAC,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,CAAC,CAC9D;SACA,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;QACb,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,IAAI,GAAG,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;QACnC,OAAO;YACL,IAAI,EAAE,KAAK,CAAC,IAAI;YAChB,IAAI,EAAE,QAAQ;YACd,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,WAAW,EAAE;SACxC,CAAC;IACJ,CAAC,CAAC;SACD,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,aAAa,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC;AAC5D,CAAC"}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@saroby/nanobanana-mcp",
+  "version": "1.0.1",
+  "description": "MCP server for Google Gemini image generation (Nano Banana)",
+  "license": "MIT",
+  "author": "saroby",
+  "type": "module",
+  "bin": {
+    "nanobanana-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/index.js",
+    "prepare": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "dependencies": {
+    "@google/genai": "^1.0.0",
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "shx": "^0.3.4",
+    "typescript": "^5.8.2"
+  }
+}