mcp-nanobanana 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Caio Rodrigo Silva
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,284 @@
+# Nano-Banana MCP Server 🍌
+
+> **Free & open-source MCP server for AI image generation and editing**, powered by Google Gemini.
+
+Generate stunning images, edit existing ones, and iterate on your creations — all through natural language prompts. Works with Claude Code, Cursor, Windsurf, and any MCP-compatible client.
+
+## ✨ Features
+
+- 🎨 **Generate Images** — Create new images from text descriptions
+- ✏️ **Edit Images** — Modify existing images with natural language instructions
+- 🔄 **Iterative Editing** — Continue refining the last generated/edited image
+- 📐 **Aspect Ratios** — Square, portrait, landscape, widescreen, stories
+- 🖼️ **Resolutions** — From 512px to 4K
+- 🤖 **3 Models** — Fast, balanced, and pro quality tiers
+- 🔧 **Zero Config** — Just add your free Gemini API key and go
+
+## 🤖 Available Models
+
+| Alias | Gemini Model | Best For |
+|-------|-------------|----------|
+| `nano-banana` | gemini-2.5-flash-image | Fast drafts & previews |
+| `nano-banana-2` | gemini-3.1-flash-image-preview | Balanced quality (default) |
+| `nano-banana-pro` | gemini-3-pro-image-preview | Highest quality results |
+
+## 🔑 Setup
+
+### 1. Get your Gemini API key (free)
+
+- Visit [Google AI Studio](https://aistudio.google.com)
+- Create a new API key
+- Copy it for configuration
+
+### 2. Install & configure
+
+See configuration examples for your specific client below.
+
+## 💻 Usage with Claude Code
+
+Add to your Claude Code MCP settings (`~/.claude/settings.json`):
+
+```json
+{
+  "mcpServers": {
+    "nanobanana": {
+      "command": "npx",
+      "args": ["-y", "mcp-nanobanana"],
+      "env": {
+        "GEMINI_API_KEY": "your-gemini-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Usage Examples
+
+```
+Generate an image of a sunset over mountains in 4K widescreen
+```
+
+```
+Edit this image to add some birds in the sky
+```
+
+```
+Continue editing — make it more dramatic
+```
+
+### 🧩 Companion Skill
+
+For the best experience with Claude Code, install the **[nanobanana-skill](https://github.com/caio-rodrigo-silva/nanobanana-skill)** — it teaches Claude how to pick the right tool, enhance prompts, and handle aspect ratios automatically:
+
+```bash
+npx skills add caio-rodrigo-silva/nanobanana-skill
+```
+
+## 🎯 Usage with Cursor
+
+Add to your Cursor MCP configuration:
+
+```json
+{
+  "nanobanana": {
+    "command": "npx",
+    "args": ["-y", "mcp-nanobanana"],
+    "env": {
+      "GEMINI_API_KEY": "your-gemini-api-key-here"
+    }
+  }
+}
+```
+
+## 🔧 For Other MCP Clients
+
+Works with any MCP-compatible client. Use the same configuration pattern:
+
+**Option A: Environment variable in MCP config (recommended)**
+
+```json
+{
+  "nanobanana": {
+    "command": "npx",
+    "args": ["-y", "mcp-nanobanana"],
+    "env": {
+      "GEMINI_API_KEY": "your-gemini-api-key-here"
+    }
+  }
+}
+```
+
+**Option B: System environment variable**
+
+```bash
+export GEMINI_API_KEY="your-gemini-api-key-here"
+npx mcp-nanobanana
+```
+
+## 🛠️ Available Tools
+
+### `generate_image`
+
+Create a new image from a text prompt.
+
+```typescript
+generate_image({
+  prompt: "A futuristic city at night with neon lights",
+  model: "nano-banana-pro",  // optional
+  aspectRatio: "16:9",       // optional
+  imageSize: "4K"            // optional
+})
+```
+
+### `edit_image`
+
+Edit an existing image with text instructions.
+
+```typescript
+edit_image({
+  imagePath: "/path/to/image.png",
+  prompt: "Add a rainbow in the sky",
+  model: "nano-banana-2",  // optional
+  aspectRatio: "4:3",      // optional
+  imageSize: "2K"          // optional
+})
+```
+
+### `continue_editing`
+
+Continue editing the last generated/edited image — no need to specify a file path.
+
+```typescript
+continue_editing({
+  prompt: "Make it more colorful",
+  aspectRatio: "1:1",  // optional
+  imageSize: "2K"      // optional
+})
+```
+
+### `get_last_image`
+
+Get information about the last generated/edited image.
+
+```typescript
+get_last_image()
+```
+
+### `get_status`
+
+Check if the API key is configured and list available models.
+
+```typescript
+get_status()
+```
+
+### `configure_api_key`
+
+Set the Gemini API key at runtime (alternative to environment variable).
+
+```typescript
+configure_api_key({
+  apiKey: "your-gemini-api-key"
+})
+```
+
+## 📐 Image Options
+
+### Aspect Ratios
+
+| Value | Use Case |
+|-------|----------|
+| `1:1` | Square — social media posts, avatars |
+| `3:4` | Portrait — vertical photos |
+| `4:3` | Landscape — horizontal photos |
+| `9:16` | Stories — Instagram/TikTok reels, phone screens |
+| `16:9` | Widescreen — presentations, cinematic |
+
+### Resolutions
+
+| Value | Notes |
+|-------|-------|
+| `512` | Fast preview (only on nano-banana-2) |
+| `1K` | Standard quality (default) |
+| `2K` | High quality |
+| `4K` | Maximum quality |
+
+## 📁 Output
+
+Images are saved to `./nanobanana-images/` relative to your working directory.
+
+You can customize the output directory with the `NANOBANANA_OUTPUT_DIR` environment variable.
+
+## 🎨 Example Workflows
+
+### Quick Image Generation
+
+1. `generate_image` — Create your base image
+2. `continue_editing` — Refine and improve
+3. `continue_editing` — Add final touches
+
+### Editing an Existing Photo
+
+1. `edit_image` — Apply changes to your image
+2. `continue_editing` — Fine-tune the result
+3. `get_last_image` — Check the output path
+
+### Iterative Design
+
+1. `generate_image` — Start with a concept
+2. `continue_editing` — Make adjustments
+3. Repeat until satisfied
+
+## 🔧 Development
+
+```bash
+# Clone the repository
+git clone https://github.com/caio-rodrigo-silva/mcp-nanobanana.git
+cd mcp-nanobanana
+
+# Install dependencies
+npm install
+
+# Build
+npm run build
+
+# Development with auto-rebuild
+npm run dev
+```
+
+### Tech Stack
+
+- **TypeScript** — Type-safe development
+- **Node.js** — Runtime environment
+- **Zod** — Schema validation
+- **@google/genai** — Google Gemini API
+- **@modelcontextprotocol/sdk** — MCP protocol
+
+## 📋 Requirements
+
+- Node.js 18+ 
+- Gemini API key from [Google AI Studio](https://aistudio.google.com) (free)
+- Any MCP-compatible client
+
+## 🤝 Contributing
+
+Contributions are welcome! Feel free to:
+
+- Report bugs
+- Suggest new features
+- Submit pull requests
+- Improve documentation
+
+## 📄 License
+
+MIT License — see [LICENSE](LICENSE) file for details.
+
+## 🔗 Links
+
+- 🐛 **Issues**: [GitHub Issues](https://github.com/caio-rodrigo-silva/mcp-nanobanana/issues)
+- 🧩 **Companion Skill**: [nanobanana-skill](https://github.com/caio-rodrigo-silva/nanobanana-skill)
+- 📖 **Gemini API**: [Google AI Studio](https://aistudio.google.com)
+
+---
+
+_Made with 🍌 by [Caio Rodrigo](https://github.com/caio-rodrigo-silva)_

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,308 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { GoogleGenAI } from "@google/genai";
+import * as fs from "fs";
+import * as path from "path";
+// --- Constants ---
+const MODELS = {
+    "nano-banana": "gemini-2.5-flash-image",
+    "nano-banana-2": "gemini-3.1-flash-image-preview",
+    "nano-banana-pro": "gemini-3-pro-image-preview",
+};
+const DEFAULT_MODEL = "nano-banana-2";
+const OUTPUT_DIR = path.resolve(process.env.NANOBANANA_OUTPUT_DIR || "nanobanana-images");
+// --- State ---
+let apiKey = process.env.GEMINI_API_KEY || "";
+let ai = null;
+let lastImagePath = "";
+let lastImageBase64 = "";
+let lastImageMimeType = "";
+// Chat sessions for multi-step editing (keyed by session name)
+const chatSessions = new Map();
+// --- Helpers ---
+function getClient() {
+    if (!apiKey) {
+        throw new Error("Gemini API key not configured. Use the configure_api_key tool to set it, or pass GEMINI_API_KEY as an environment variable.");
+    }
+    if (!ai) {
+        ai = new GoogleGenAI({ apiKey });
+    }
+    return ai;
+}
+function ensureOutputDir() {
+    if (!fs.existsSync(OUTPUT_DIR)) {
+        fs.mkdirSync(OUTPUT_DIR, { recursive: true });
+    }
+}
+function resolveModel(model) {
+    if (!model)
+        return MODELS[DEFAULT_MODEL];
+    if (model in MODELS)
+        return MODELS[model];
+    // Allow passing the full model ID directly
+    return model;
+}
+function saveImage(base64Data, mimeType, prefix) {
+    ensureOutputDir();
+    const ext = mimeType.includes("png") ? "png" : "jpg";
+    const timestamp = Date.now();
+    const filename = `${prefix}_${timestamp}.${ext}`;
+    const filePath = path.join(OUTPUT_DIR, filename);
+    const buffer = Buffer.from(base64Data, "base64");
+    fs.writeFileSync(filePath, buffer);
+    lastImagePath = filePath;
+    lastImageBase64 = base64Data;
+    lastImageMimeType = mimeType;
+    return filePath;
+}
+function readImageAsBase64(imagePath) {
+    const resolved = path.resolve(imagePath);
+    if (!fs.existsSync(resolved)) {
+        throw new Error(`Image not found: ${resolved}`);
+    }
+    const buffer = fs.readFileSync(resolved);
+    const ext = path.extname(resolved).toLowerCase();
+    const mimeMap = {
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".webp": "image/webp",
+        ".gif": "image/gif",
+    };
+    const mimeType = mimeMap[ext] || "image/png";
+    return { data: buffer.toString("base64"), mimeType };
+}
+function extractImageAndText(response) {
+    let text = "";
+    let imagePath = null;
+    const parts = response.candidates?.[0]?.content?.parts || [];
+    for (const part of parts) {
+        if (part.text) {
+            text += part.text;
+        }
+        else if (part.inlineData) {
+            imagePath = saveImage(part.inlineData.data, part.inlineData.mimeType, "generated");
+        }
+    }
+    return { text, imagePath };
+}
+// --- MCP Server ---
+const server = new McpServer({
+    name: "mcp-nanobanana",
+    version: "1.0.0",
+});
+// Tool: configure_api_key
+server.tool("configure_api_key", "Set the Gemini API key for image generation. Get yours at aistudio.google.com", { apiKey: z.string().min(1).describe("Your Gemini API key") }, async ({ apiKey: key }) => {
+    apiKey = key;
+    ai = null; // Reset client to pick up new key
+    return {
+        content: [{ type: "text", text: "API key configured successfully." }],
+    };
+});
+// Tool: get_status
+server.tool("get_status", "Check if the Gemini API key is configured and list available models", {}, async () => {
+    const configured = !!apiKey;
+    const modelList = Object.entries(MODELS)
+        .map(([alias, id]) => `  - ${alias}: ${id}${alias === DEFAULT_MODEL ? " (default)" : ""}`)
+        .join("\n");
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    `API Key: ${configured ? "Configured" : "Not configured — use configure_api_key or set GEMINI_API_KEY env var"}`,
+                    `Output directory: ${OUTPUT_DIR}`,
+                    `Last image: ${lastImagePath || "None"}`,
+                    `\nAvailable models:\n${modelList}`,
+                ].join("\n"),
+            },
+        ],
+    };
+});
+// Tool: generate_image
+server.tool("generate_image", "Generate a new image from a text description. Returns the file path of the saved image. Use detailed, descriptive prompts for best results.", {
+    prompt: z.string().min(1).describe("Detailed text description of the image to generate"),
+    model: z
+        .enum(["nano-banana", "nano-banana-2", "nano-banana-pro"])
+        .optional()
+        .describe("Model to use. nano-banana (fast), nano-banana-2 (balanced, default), nano-banana-pro (highest quality)"),
+    aspectRatio: z
+        .enum(["1:1", "3:4", "4:3", "9:16", "16:9"])
+        .optional()
+        .describe("Aspect ratio of the generated image"),
+    imageSize: z
+        .enum(["512", "1K", "2K", "4K"])
+        .optional()
+        .describe("Image resolution. 512 only supported on nano-banana-2. Default is 1K"),
+}, async ({ prompt, model, aspectRatio, imageSize }) => {
+    const client = getClient();
+    const modelId = resolveModel(model);
+    const imageConfig = {};
+    if (aspectRatio)
+        imageConfig.aspectRatio = aspectRatio;
+    if (imageSize)
+        imageConfig.imageSize = imageSize;
+    const response = await client.models.generateContent({
+        model: modelId,
+        contents: prompt,
+        config: {
+            responseModalities: ["TEXT", "IMAGE"],
+            ...(Object.keys(imageConfig).length > 0 && { imageConfig }),
+        },
+    });
+    const { text, imagePath } = extractImageAndText(response);
+    if (!imagePath) {
+        return {
+            content: [{ type: "text", text: text || "No image was generated. Try a more descriptive prompt." }],
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: `Image saved to: ${imagePath}${text ? `\n\n${text}` : ""}` },
+        ],
+    };
+});
+// Tool: edit_image
+server.tool("edit_image", "Edit an existing image using text instructions. Provide the image path and describe what changes to make.", {
+    imagePath: z.string().min(1).describe("Absolute path to the image file to edit"),
+    prompt: z.string().min(1).describe("Instructions for how to edit the image"),
+    model: z
+        .enum(["nano-banana", "nano-banana-2", "nano-banana-pro"])
+        .optional()
+        .describe("Model to use. nano-banana (fast), nano-banana-2 (balanced, default), nano-banana-pro (highest quality)"),
+    aspectRatio: z
+        .enum(["1:1", "3:4", "4:3", "9:16", "16:9"])
+        .optional()
+        .describe("Aspect ratio of the output image"),
+    imageSize: z
+        .enum(["512", "1K", "2K", "4K"])
+        .optional()
+        .describe("Image resolution. 512 only supported on nano-banana-2. Default is 1K"),
+}, async ({ imagePath: imgPath, prompt, model, aspectRatio, imageSize }) => {
+    const client = getClient();
+    const modelId = resolveModel(model);
+    const { data, mimeType } = readImageAsBase64(imgPath);
+    const imageConfig = {};
+    if (aspectRatio)
+        imageConfig.aspectRatio = aspectRatio;
+    if (imageSize)
+        imageConfig.imageSize = imageSize;
+    const response = await client.models.generateContent({
+        model: modelId,
+        contents: [
+            {
+                role: "user",
+                parts: [
+                    { text: prompt },
+                    { inlineData: { mimeType, data } },
+                ],
+            },
+        ],
+        config: {
+            responseModalities: ["TEXT", "IMAGE"],
+            ...(Object.keys(imageConfig).length > 0 && { imageConfig }),
+        },
+    });
+    const { text, imagePath: savedPath } = extractImageAndText(response);
+    if (!savedPath) {
+        return {
+            content: [{ type: "text", text: text || "No edited image was returned. Try different instructions." }],
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: `Edited image saved to: ${savedPath}${text ? `\n\n${text}` : ""}` },
+        ],
+    };
+});
+// Tool: continue_editing
+server.tool("continue_editing", "Continue editing the last generated or edited image. No need to specify a file path — works on the most recent image.", {
+    prompt: z.string().min(1).describe("Instructions for further editing the last image"),
+    model: z
+        .enum(["nano-banana", "nano-banana-2", "nano-banana-pro"])
+        .optional()
+        .describe("Model to use. nano-banana (fast), nano-banana-2 (balanced, default), nano-banana-pro (highest quality)"),
+    aspectRatio: z
+        .enum(["1:1", "3:4", "4:3", "9:16", "16:9"])
+        .optional()
+        .describe("Aspect ratio of the output image"),
+    imageSize: z
+        .enum(["512", "1K", "2K", "4K"])
+        .optional()
+        .describe("Image resolution. 512 only supported on nano-banana-2. Default is 1K"),
+}, async ({ prompt, model, aspectRatio, imageSize }) => {
+    if (!lastImageBase64) {
+        return {
+            content: [{ type: "text", text: "No previous image to edit. Use generate_image or edit_image first." }],
+        };
+    }
+    const client = getClient();
+    const modelId = resolveModel(model);
+    const imageConfig = {};
+    if (aspectRatio)
+        imageConfig.aspectRatio = aspectRatio;
+    if (imageSize)
+        imageConfig.imageSize = imageSize;
+    const response = await client.models.generateContent({
+        model: modelId,
+        contents: [
+            {
+                role: "user",
+                parts: [
+                    { text: prompt },
+                    { inlineData: { mimeType: lastImageMimeType, data: lastImageBase64 } },
+                ],
+            },
+        ],
+        config: {
+            responseModalities: ["TEXT", "IMAGE"],
+            ...(Object.keys(imageConfig).length > 0 && { imageConfig }),
+        },
+    });
+    const { text, imagePath } = extractImageAndText(response);
+    if (!imagePath) {
+        return {
+            content: [{ type: "text", text: text || "No edited image was returned. Try different instructions." }],
+        };
+    }
+    return {
+        content: [
+            { type: "text", text: `Edited image saved to: ${imagePath}${text ? `\n\n${text}` : ""}` },
+        ],
+    };
+});
+// Tool: get_last_image
+server.tool("get_last_image", "Get information about the last generated or edited image, including its file path.", {}, async () => {
+    if (!lastImagePath) {
+        return {
+            content: [{ type: "text", text: "No image has been generated yet in this session." }],
+        };
+    }
+    const exists = fs.existsSync(lastImagePath);
+    const stats = exists ? fs.statSync(lastImagePath) : null;
+    return {
+        content: [
+            {
+                type: "text",
+                text: [
+                    `Path: ${lastImagePath}`,
+                    `Exists: ${exists}`,
+                    `Size: ${stats ? `${(stats.size / 1024).toFixed(1)} KB` : "N/A"}`,
+                    `Type: ${lastImageMimeType}`,
+                ].join("\n"),
+            },
+        ],
+    };
+});
+// --- Start Server ---
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((error) => {
+    console.error("Server failed to start:", 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":"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"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "mcp-nanobanana",
+  "version": "1.0.0",
+  "description": "MCP server for AI image generation and editing powered by Google Gemini",
+  "author": "Caio Rodrigo Silva",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/caio-rodrigo-silva/mcp-nanobanana.git"
+  },
+  "homepage": "https://github.com/caio-rodrigo-silva/mcp-nanobanana#readme",
+  "bugs": {
+    "url": "https://github.com/caio-rodrigo-silva/mcp-nanobanana/issues"
+  },
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-nanobanana": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "LICENSE",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "nanobanana",
+    "gemini",
+    "image-generation",
+    "image-editing",
+    "ai",
+    "google-gemini"
+  ],
+  "type": "module",
+  "license": "MIT",
+  "dependencies": {
+    "@google/genai": "^1.16.0",
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.22.4"
+  },
+  "devDependencies": {
+    "typescript": "^5.4.0",
+    "@types/node": "^20.0.0"
+  }
+}