de en es ja ko ru zh

mcp-alphabanana

Name: mcp-alphabanana
Author: tasopen

by tasopen

Overview Schema Source Related Servers Discussions Admin

TypeScript

mcp-alphabanana

npm version License: MIT

Inglés | 日本語

mcp-alphabanana es un servidor del Protocolo de Contexto de Modelo (MCP) para generar recursos de imagen con Google Gemini. Está diseñado para clientes compatibles con MCP y flujos de trabajo de agentes que necesitan generación rápida de imágenes, salidas transparentes, guía mediante imágenes de referencia y formatos de entrega flexibles.

Palabras clave: Servidor MCP, Protocolo de Contexto de Modelo, Gemini AI, generación de imágenes, FastMCP

Capacidades clave:

Generación de imágenes ultrarrápida con Gemini en los niveles Flash y Pro
Salida de recursos PNG/WebP transparentes para flujos de trabajo web y de juegos
Guía de estilo con múltiples imágenes mediante archivos de imagen de referencia locales
Salidas flexibles en archivo, base64 o combinadas para flujos de trabajo de agentes

alphabanana demo

Inicio rápido

Ejecuta el servidor MCP con npx:

npx -y @tasopen/mcp-alphabanana

O añádelo a tu configuración de MCP:

{
  "mcp": {
    "servers": {
      "alphabanana": {
        "command": "npx",
        "args": ["-y", "@tasopen/mcp-alphabanana"],
        "env": {
          "GEMINI_API_KEY": "${env:GEMINI_API_KEY}"
        }
      }
    }
  }
}

Establece GEMINI_API_KEY antes de iniciar el servidor.

Para Claude Desktop, Descarga mcp-alphabanana-latest.mcpb, luego añádelo como extensión desde la configuración de Claude Desktop. Para Windows, se recomienda añadir la extensión 'FileSystem' para un mejor manejo de archivos locales.
Download MCPB

Related MCP server: nano-banana-claude

Registro de Claude

El registro de Claude / metadatos del paquete MCPB se definen en manifest.json y se envían con el icono estático de 512x512 en images/mcp-alphabanana.png.

Los paquetes de tiempo de ejecución nativos de sharp se declaran como dependencias opcionales para que las instalaciones de .mcpb puedan resolver el binario precompilado correcto en cada plataforma compatible sin depender de hooks de postinstalación.

URL estable de MCPB: https://github.com/tasopen/mcp-alphabanana/releases/latest/download/mcp-alphabanana-latest.mcpb
Patrón de URL versionada de MCPB: https://github.com/tasopen/mcp-alphabanana/releases/download/vVERSION/mcp-alphabanana-VERSION.mcpb
Soporte: GitHub Issues

Servidor MCP

Este repositorio proporciona un servidor MCP que permite a los agentes de IA generar imágenes usando Google Gemini.

Puede utilizarse con clientes compatibles con MCP como:

Claude Desktop
VS Code MCP
Cursor

Construido con FastMCP 3 para una base de código simplificada y opciones de salida flexibles.

Insignia del servidor Glama MCP:\

Herramientas disponibles

generate_image

Genera imágenes usando Google Gemini con transparencia opcional, imágenes de referencia locales, fundamentación y metadatos de razonamiento.

Para Claude Desktop, prefiere outputType=file para imágenes medianas o grandes. Las respuestas base64 y combine consumen contexto de Claude y pueden alcanzar el límite de tamaño del cliente. En Windows, usa la extensión FileSystem para elegir una outputPath absoluta escribible y cualquier ruta de referenceImages local.

Parámetros clave:

prompt (string): descripción de la imagen a generar
model: Flash3.1, Flash2.5, Pro3, flash, pro
outputWidth y outputHeight: tamaño final de imagen solicitado en píxeles en modo normal
noresize + aspectRatio + output_resolution: devuelve el tamaño nativo de Gemini sin cambiar el tamaño
output_resolution: 0.5K, 1K, 2K, 4K
output_format: png, jpg, webp
outputType: file, base64, combine
outputPath: requerido cuando outputType es file o combine
transparent: habilita el postprocesamiento de PNG/WebP transparente
referenceImages: matriz opcional de archivos de imagen de referencia locales
grounding_type y thinking_mode: controles avanzados de Gemini 3.1

Selección de modelo

ID de modelo de entrada	ID de modelo interno	Descripción
`Flash3.1`	`gemini-3.1-flash-image-preview`	Ultrarrápido, admite Pensamiento/Fundamentación.
`Flash2.5`	`gemini-2.5-flash-image`	Flash heredado. Alta estabilidad. Bajo costo.
`Pro3`	`gemini-3.0-pro-image-preview`	Modelo Pro de alta fidelidad.
`flash`	`gemini-3.1-flash-image-preview`	Alias para compatibilidad con versiones anteriores.
`pro`	`gemini-3.0-pro-image-preview`	Alias para compatibilidad con versiones anteriores.

Parámetros

Referencia completa de parámetros para la herramienta generate_image.

Parámetro	Tipo	Predeterminado	Descripción
`prompt`	string	requerido	Descripción de la imagen a generar
`outputFileName`	string	requerido	Nombre del archivo de salida (extensión añadida automáticamente si falta)
`outputType`	enum	`combine`	`file`, `base64` o `combine`
`model`	enum	`Flash3.1`	Modelo: `Flash3.1`, `Flash2.5`, `Pro3`, `flash`, `pro`
`output_resolution`	enum	auto	`0.5K`, `1K`, `2K`, `4K`; requerido cuando `noresize=true`
`noresize`	boolean	`false`	Saltar el cambio de tamaño posterior a la generación y devolver dimensiones nativas de Gemini
`aspectRatio`	enum	opcional	Requerido cuando `noresize=true`; ej. `1:1`, `16:9`, `4:5`
`outputWidth`	integer	requerido salvo `noresize=true`	Ancho de salida final en píxeles
`outputHeight`	integer	requerido salvo `noresize=true`	Altura de salida final en píxeles
`output_format`	enum	`png`	`png`, `jpg`, `webp`
`outputPath`	string	requerido para `file` / `combine`	Ruta del directorio de salida absoluto
`transparent`	boolean	`false`	Fondo transparente (solo PNG/WebP)
`transparentColor`	string o null	`null`	Anulación de clave de color para extracción de transparencia
`colorTolerance`	integer	`30`	Tolerancia de coincidencia de color de transparencia
`fringeMode`	enum	`auto`	`auto`, `crisp`, `hd`
`resizeMode`	enum	`crop`	`crop`, `stretch`, `letterbox`, `contain`
`grounding_type`	enum	`none`	`none`, `text`, `image`, `both` (solo Flash3.1)
`thinking_mode`	enum	`minimal`	`minimal`, `high` (solo Flash3.1)
`include_thoughts`	boolean	`false`	Devolver campos de razonamiento del modelo cuando los metadatos están habilitados
`include_metadata`	boolean	`false`	Incluir metadatos de fundamentación y razonamiento en la salida JSON
`referenceImages`	array	`[]`	Hasta 14 archivos de referencia locales (Flash3.1/Pro3), 3 para Flash2.5
`debug`	boolean	`false`	Guardar artefactos de depuración intermedios

¿Por qué alphabanana?

Sin marcas de agua: Imágenes limpias nativas de la API.
Soporte de Pensamiento/Fundamentación: Mayor adherencia a las instrucciones y precisión respaldada por búsqueda.
Listo para producción: Admite WebP transparente y relaciones de aspecto exactas para recursos web y de juegos.

Características

Generación de imágenes ultrarrápida (Gemini 3.1 Flash, 0.5K/1K/2K/4K)
Razonamiento avanzado con múltiples imágenes (hasta 14 imágenes de referencia)
Soporte de Pensamiento/Fundamentación (solo Flash3.1)
Salida PNG/WebP transparente (postprocesamiento de clave de color, eliminación de bordes)
Múltiples formatos de salida: archivo, base64 o ambos
Modos de cambio de tamaño flexibles: recortar, estirar, letterbox, contener
Múltiples niveles de modelo: Flash3.1, Flash2.5, Pro3, alias heredados

Ejemplos de salida

Estos ejemplos de salida se generaron con mcp-alphabanana y se almacenaron en images/examples.

Recurso de pixel art	Escena de juego con imagen de referencia	Generación fotorrealista

Configuración

Configura GEMINI_API_KEY en tu configuración de MCP (por ejemplo, mcp.json).

Ejemplos:

Referenciar una variable de entorno del SO desde mcp.json:

{
  "env": {
    "GEMINI_API_KEY": "${env:GEMINI_API_KEY}"
  }
}

Proporcionar la clave directamente en mcp.json:

{
  "env": {
    "GEMINI_API_KEY": "your_api_key_here"
  }
}

Integración con VS Code

Añádelo a tu configuración de VS Code (.vscode/settings.json o configuración de usuario), configurando el env del servidor en mcp.json o a través de la configuración de MCP de VS Code.

{
  "mcp": {
    "servers": {
      "mcp-alphabanana": {
        "command": "npx",
        "args": ["-y", "@tasopen/mcp-alphabanana"],
        "env": {
          "GEMINI_API_KEY": "${env:GEMINI_API_KEY}"
        }
      }
    }
  }
}

Opcional: Establece un directorio de respaldo personalizado para fallos de escritura añadiendo MCP_FALLBACK_OUTPUT al objeto env.

Ejemplos de uso

Generación básica

{
  "prompt": "A pixel art treasure chest, golden trim, wooden texture",
  "model": "Flash3.1",
  "outputFileName": "chest",
  "outputType": "base64",
  "outputWidth": 64,
  "outputHeight": 64,
  "transparent": true
}

Tamaño nativo sin cambio de tamaño

{
  "prompt": "A clean app icon with a banana mascot, flat graphic design",
  "model": "Flash3.1",
  "outputFileName": "banana-icon-native",
  "outputType": "base64",
  "noresize": true,
  "aspectRatio": "1:1",
  "output_resolution": "0.5K",
  "output_format": "png"
}

Este modo devuelve el tamaño de píxel nativo de Gemini para la relación y resolución solicitadas. Por ejemplo, 1:1 + 0.5K devuelve 512x512 sin ningún paso de cambio de tamaño.

Avanzado (Póster vertical y pensamiento)

{
  "prompt": "A vertical, photorealistic travel poster advertising Magical Wings Day Tours. A joyful young couple flies high above a breathtaking European countryside at golden hour, holding hands as they soar through a partly cloudy sky. Below them are vineyards, villages, forests, a winding river, and a hilltop medieval castle. The poster uses large, elegant typography with the headline FLY THE COUNTRYSIDE at the top and Magical Wings Day Tours branding near the bottom.",
  "model": "Flash3.1",
  "output_resolution": "1K",
  "outputFileName": "photoreal-travel-poster",
  "outputType": "file",
  "outputPath": "/path/to/output",
  "outputWidth": 848,
  "outputHeight": 1264,
  "output_format": "jpg",
  "thinking_mode": "high",
  "include_metadata": true
}

Muestra de fundamentación (respaldada por búsqueda)

{
  "prompt": "A modern travel poster featuring today's weather and skyline highlights in Kuala Lumpur",
  "model": "Flash3.1",
  "outputFileName": "kl_travel_poster",
  "outputType": "base64",
  "outputWidth": 1024,
  "outputHeight": 1024,
  "grounding_type": "text",
  "thinking_mode": "high",
  "include_metadata": true,
  "include_thoughts": true
}

Esta muestra habilita la fundamentación de Google Search y devuelve metadatos de fundamentación y razonamiento en JSON.

Con imágenes de referencia

{
  "prompt": "Use the reference image to create a game screen showing an opened treasure chest filled with coins and treasure, 8-bit dungeon crawler style, after-battle reward scene, dungeon corridor background, four-party status UI at the bottom",
  "model": "Flash3.1",
  "output_resolution": "0.5K",
  "outputFileName": "reference-image-dungeon-loot",
  "outputType": "file",
  "outputPath": "/path/to/output",
  "outputWidth": 600,
  "outputHeight": 448,
  "output_format": "webp",
  "transparent": false,
  "referenceImages": [
    {
      "description": "Treasure chest style reference",
      "filePath": "/path/to/references/pixel-art-treasure-chest.png"
    }
  ]
}

Transparencia y formatos de salida

PNG: Alfa completo, clave de color + eliminación de bordes
WebP: Alfa completo, mejor compresión (Flash3.1+)
JPEG: Sin transparencia (vuelve a un fondo sólido)

Desarrollo

# Development mode with MCP CLI
npm run dev

# MCP Inspector (Web UI)
npm run inspect

# Build for production
npm run build

Licencia

MIT

Available Tools

1 tool

generate_imageA

Destructive

Generate image assets using Gemini AI with optional transparency and reference images.

[Claude Desktop Guidance]

Prefer outputType='file' for medium or large images. base64 and combine responses can exceed Claude Desktop's context limit.
On Claude Desktop for Windows, use the FileSystem extension to choose reference-image paths and a writable absolute outputPath before calling this tool.
Use base64 only for small previews or when the client explicitly needs inline image data.

[Model Guidance]

NanoBanana2.1 (default): Google Nano Banana 2.1 (gemini-nano-banana-2.1). Best overall quality, prompt adherence, character consistency, text rendering and reference-image handling. Supports 1K/2K/4K and up to 14 reference images, plus thinking and grounding.
Flash3.1 (deprecated): gemini-3.1-flash-image. Google shuts it down on October 29, 2026; requests are rejected from that date. Please migrate to NanoBanana2.1.
Lite3.1 (Nano Banana 2 Lite): Ultra-fast, cost-effective, 1K-only, no search grounding. Ideal for quick drafting and low-latency iteration.
Pro3: Higher fidelity, but more costly and slower.
Flash2.5: Legacy, maintained for compatibility. 1K only. Aliases: 'flash' resolves to NanoBanana2.1 (the default), 'pro' to Pro3.

[Thinking] thinking_mode accepts minimal, medium, high (default: medium, matching NanoBanana2.1's model default). NanoBanana2.1 supports all three levels; Flash3.1 and Pro3 support minimal/high and fall back to their own default when given an unsupported level.

[Resolutions] output_resolution supports 1K, 2K and 4K (0.5K was removed in v1.6.0). It is auto-selected from the requested pixel size in normal mode.

[Aspect Ratios] Gemini supports the following aspect ratios (model-dependent):

Common to all models: 1:1, 2:3, 3:2, 3:4, 4:3, 4:5, 5:4, 9:16, 16:9, 21:9
Flash3.1 only: 1:4, 4:1, 1:8, 8:1

Normal mode: provide outputWidth/outputHeight and the server will choose the closest Gemini aspect ratio and source resolution, then resize to the requested pixel size. No-resize mode: set noresize=true and provide aspectRatio plus output_resolution. The server will return Gemini's native pixel dimensions for that combination without post-generation resizing.

If you intentionally want to control resizing/cropping in normal mode, use the 'resizeMode' parameter: 'crop' (default, center crop), 'letterbox' (fit with padding), 'contain' (trim transparent margins then fit), or 'stretch' (distort to fit).

[IMPORTANT] Always preserve the user's prompt as-is, including language and nuance. Do not translate or summarize.

Name	Required	Description	Default
`debug`	No	Debug mode: output intermediate processing images and prompt
`model`	No	Model tier to use for generation (default: NanoBanana2.1; see tool description for details; "flash" resolves to NanoBanana2.1, "pro" to Pro3; "Lite3.1" is the low-latency Nano Banana 2 Lite model, 1K-only, no grounding; "Flash3.1" is deprecated — Google shuts it down on October 29, 2026)	NanoBanana2.1
`prompt`	Yes	User-provided image prompt. Preserve the original wording and detail; do not summarize or translate. Only append transparency-related hints if needed.
`noresize`	No	Skip post-generation resizing and return Gemini native dimensions directly. When true, provide aspectRatio and output_resolution instead of outputWidth/outputHeight.
`fringeMode`	No	Fringe reduction mode: auto (size-based), crisp (binary alpha), hd (force-clear 1px boundary for large images).	auto
`outputPath`	No	Output directory path (MUST be an absolute path when outputType is file or combine). In Claude Desktop on Windows, use the FileSystem extension to choose or prepare a writable absolute path such as C:\temp.
`outputType`	No	Output format: file=file only, base64=base64 only, combine=both. In Claude Desktop, prefer file for medium or large images to avoid context-size limits; use base64 only for small previews.	combine
`resizeMode`	No	Resize mode: crop=center crop, stretch=distort, letterbox=fit with padding, contain=trim transparent margins then fit	crop
`aspectRatio`	No	Gemini aspect ratio to use directly when noresize=true. Ignored in normal resize mode.
`outputWidth`	No	Output image width in pixels. Required unless noresize=true. In normal mode, the image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this width.
`transparent`	No	Request transparent background (PNG or WebP only). Background color is selected by histogram analysis.
`outputHeight`	No	Output image height in pixels. Required unless noresize=true. In normal mode, the image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this height.
`output_format`	No	Output format	png
`thinking_mode`	No	Thinking level: minimal, medium, high (default: medium, matching NanoBanana2.1's model default; requires a thinking-capable model — NanoBanana2.1 accepts all three levels, Flash3.1/Pro3 accept minimal/high and fall back to their own default otherwise)	medium
`colorTolerance`	No	Tolerance for color matching (0-255). Higher values are more permissive for transparent color selection and keying.
`grounding_type`	No	Grounding tool usage (requires a grounding-capable model; see [Model Guidance] in the tool description)	none
`outputFileName`	Yes	Output filename (extension auto-added if missing)
`referenceImages`	No	Reference images for style guidance (max 14 files; per-model limits are enforced automatically)
`include_metadata`	No	Include grounding and reasoning metadata in JSON output (optional, may increase payload size).
`include_thoughts`	No	Optional (default: false). Request thought fields from Gemini (thinking-capable models only). Thought content is returned in MCP response only when include_metadata=true.
`transparentColor`	No	Color to make transparent. Hex (e.g. #FF00FF). null defaults to #FF00FF when transparent=true.
`output_resolution`	No	Gemini generation source resolution: 1K, 2K, and 4K (optional in normal mode, required when noresize=true; 0.5K was removed in v1.6.0). In normal mode, the final image is resized to the requested pixel size after generation.

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations declare destructiveHint=true and openWorldHint=true, and the description adds substantial behavioral context beyond them: model deprecation dates, fallback behavior for unsupported thinking levels, histogram-based background selection, and the auto-resize pipeline. It does not explain the destructive aspect — notably whether an existing file at outputPath is overwritten — which is the main remaining gap.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded purpose followed by clearly bracketed sections, so the agent can scan to the relevant concern. It is long and the [Thinking], [Resolutions], and [Aspect Ratios] sections restate schema parameter descriptions, so not every sentence is strictly additive.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a 22-parameter tool with no output schema, the description covers client constraints, model tiers, mode interplay, and prompt-preservation rules. It leaves unstated what happens on unwritable outputPath or on overwrite of an existing file, which matters given destructiveHint=true.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds model-dependent semantics not in the schema: which aspect ratios are Flash3.1-only, that aliases resolve ('flash' to NanoBanana2.1, 'pro' to Pro3), and how normal vs noresize mode changes which of outputWidth/outputHeight, aspectRatio, and output_resolution matter.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The opening sentence states a specific verb and resource ('Generate image assets using Gemini AI') plus the two distinguishing capabilities (optional transparency, reference images). With no sibling tools to disambiguate against, this fully identifies the operation.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives explicit when-to-use rules: prefer outputType='file' for medium/large images, base64 only for small previews, use FileSystem extension on Windows for reference paths, and normal mode vs noresize mode selection. Model selection is also routed with named tradeoffs (Lite3.1 for drafting, Pro3 for fidelity).

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

1 tool updatev1.6.0Oct 14, 2026

Changedgenerate_image13 fields changed

changedInput schema / properties / grounding_type / description

Previous value: -"Grounding tool usage (3.1 only)"New value: +"Grounding tool usage (requires a grounding-capable model; see [Model Guidance] in the tool description)"

changedInput schema / properties / include_thoughts / description

Previous value: -"Optional (default: false). Request thought fields from Gemini (3.1 only). Thought content is returned in MCP response only when include_metadata=true."New value: +"Optional (default: false). Request thought fields from Gemini (thinking-capable models only). Thought content is returned in MCP response only when include_metadata=true."

changedInput schema / properties / model / default

Previous value: -"Flash3.1"New value: +"NanoBanana2.1"

changedInput schema / properties / model / description

Previous value: -"Model tier to use for generation (see tool description for details; \"flash\" and \"pro\" are aliases for Flash2.5 and Pro3; \"Lite3.1\" is the low-latency Nano Banana 2 Lite model, 1K-only, no grounding)"New value: +"Model tier to use for generation (default: NanoBanana2.1; see tool description for details; \"flash\" resolves to NanoBanana2.1, \"pro\" to Pro3; \"Lite3.1\" is the low-latency Nano Banana 2 Lite model, 1K-only, no grounding; \"Flash3.1\" is deprecated — Google shuts it down on October 29, 2026)"

changedInput schema / properties / model / enum

Previous value: -[
-  "Flash3.1",
-  "Lite3.1",
-  "Flash2.5",
-  "Pro3",
-  "flash",
-  "pro"
-]New value: +[
+  "NanoBanana2.1",
+  "Flash3.1",
+  "Lite3.1",
+  "Flash2.5",
+  "Pro3",
+  "flash",
+  "pro"
+]

changedInput schema / properties / output_resolution / description

Previous value: -"Gemini generation source resolution (optional in normal mode, required when noresize=true). In normal mode, the final image is resized to the requested pixel size after generation."New value: +"Gemini generation source resolution: 1K, 2K, and 4K (optional in normal mode, required when noresize=true; 0.5K was removed in v1.6.0). In normal mode, the final image is resized to the requested pixel size after generation."

removedInput schema / properties / output_resolution / enum

Removed value: -[
-  "0.5K",
-  "1K",
-  "2K",
-  "4K"
-]

changedInput schema / properties / referenceImages / description

Previous value: -"Reference images for style guidance (Flash2.5: max 3, others: max 14)"New value: +"Reference images for style guidance (max 14 files; per-model limits are enforced automatically)"

changedInput schema / properties / thinking_mode / default
```
Previous value: -"minimal"New value: +"medium"
```

changedInput schema / properties / thinking_mode / description

Previous value: -"Thinking mode (3.1 only)"New value: +"Thinking level: minimal, medium, high (default: medium, matching NanoBanana2.1's model default; requires a thinking-capable model — NanoBanana2.1 accepts all three levels, Flash3.1/Pro3 accept minimal/high and fall back to their own default otherwise)"

changedInput schema / properties / thinking_mode / enum

Previous value: -[
-  "minimal",
-  "high"
-]New value: +[
+  "minimal",
+  "medium",
+  "high"
+]

removedInput schema / properties / transparentColor / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

addedInput schema / properties / transparentColor / type
```
Added value: +[
+  "string",
+  "null"
+]
```

1 tool updatev1.5.0Jul 12, 2026

Changedgenerate_image14 fields changed

addedInput schema / properties / aspectRatio

Added value: +{
+  "description": "Gemini aspect ratio to use directly when noresize=true. Ignored in normal resize mode.",
+  "enum": [
+    "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"
+  ],
+  "type": "string"
+}

changedInput schema / properties / model / description

Previous value: -"Model tier to use for generation (see tool description for details; \"flash\" and \"pro\" are aliases for Flash2.5 and Pro3)"New value: +"Model tier to use for generation (see tool description for details; \"flash\" and \"pro\" are aliases for Flash2.5 and Pro3; \"Lite3.1\" is the low-latency Nano Banana 2 Lite model, 1K-only, no grounding)"

changedInput schema / properties / model / enum

Previous value: -[
-  "Flash3.1",
-  "Flash2.5",
-  "Pro3",
-  "flash",
-  "pro"
-]New value: +[
+  "Flash3.1",
+  "Lite3.1",
+  "Flash2.5",
+  "Pro3",
+  "flash",
+  "pro"
+]

addedInput schema / properties / noresize

Added value: +{
+  "default": false,
+  "description": "Skip post-generation resizing and return Gemini native dimensions directly. When true, provide aspectRatio and output_resolution instead of outputWidth/outputHeight.",
+  "type": "boolean"
+}

changedInput schema / properties / outputHeight / description

Previous value: -"Output image height in pixels. The image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this height. To avoid cropping or padding, set width and height to match a supported aspect ratio (see tool description)."New value: +"Output image height in pixels. Required unless noresize=true. In normal mode, the image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this height."

changedInput schema / properties / outputPath / description

Previous value: -"Output directory path (MUST be an absolute path when outputType is file or combine)"New value: +"Output directory path (MUST be an absolute path when outputType is file or combine). In Claude Desktop on Windows, use the FileSystem extension to choose or prepare a writable absolute path such as C:\\temp."

changedInput schema / properties / outputType / description

Previous value: -"Output format: file=file only, base64=base64 only, combine=both"New value: +"Output format: file=file only, base64=base64 only, combine=both. In Claude Desktop, prefer file for medium or large images to avoid context-size limits; use base64 only for small previews."

changedInput schema / properties / outputWidth / description

Previous value: -"Output image width in pixels. The image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this width. To avoid cropping or padding, set width and height to match a supported aspect ratio (see tool description)."New value: +"Output image width in pixels. Required unless noresize=true. In normal mode, the image will be generated using the closest supported Gemini aspect ratio and resolution, then resized to this width."

changedInput schema / properties / output_resolution / description

Previous value: -"Gemini generation source resolution (optional; normally auto-calculated from pixel size. Set only to override. Final image is resized to requested pixel size.)"New value: +"Gemini generation source resolution (optional in normal mode, required when noresize=true). In normal mode, the final image is resized to the requested pixel size after generation."

removedInput schema / properties / referenceImages / items / additionalProperties
```
Removed value: -false
```

changedInput schema / properties / referenceImages / items / properties / filePath / description

Previous value: -"Absolute path to reference image file (.png, .jpg, .jpeg, .webp)"New value: +"Absolute path to reference image file (.png, .jpg, .jpeg, .webp). In Claude Desktop on Windows, use the FileSystem extension to locate the file and pass its Windows absolute path."

addedInput schema / properties / transparentColor / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

removedInput schema / properties / transparentColor / type
```
Removed value: -[
-  "string",
-  "null"
-]
```

changedInput schema / required

Previous value: -[
-  "prompt",
-  "outputFileName",
-  "outputWidth",
-  "outputHeight"
-]New value: +[
+  "prompt",
+  "outputFileName"
+]

1 tool updatev1.3.6Mar 15, 2026
- First observedgenerate_image

Deploy Server

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.4/5.0

Scored 2026-10-16 00:20 across 1 tool

Disambiguation5/5

With a single tool there is no possibility of misselection; generate_image has one unambiguous purpose. The extensive guidance distinguishes modes and parameters rather than competing tools, so no disambiguation burden is placed on the agent.

Naming Consistency5/5

generate_image follows a clear verb_noun snake_case pattern. There are no other names to conflict with, so consistency is trivially satisfied and readable.

Tool Count3/5

A one-tool surface is thin for what is effectively a full image-generation service with multiple models, resolutions, reference handling, and resize modes. Much of that surface is expressed through parameters and documentation rather than discoverable tools, making the count borderline.

Completeness4/5

Core generation is well covered: model choice, resolution, aspect ratio, transparency, reference images, and resize behavior are all parameterized. Minor gaps exist around ancillary operations such as editing/upscaling existing assets or programmatically listing available models, which are only described in prose guidance.

Maintenance

ActivityMaintained

ResponsivenessSyncing

Resources

Related MCP Connectors

mcp-qwen-image
io.github.AceDataCloud
MCP server for Qwen Image 3 AI image generation
AI & Machine Learning Image & Video Processing
1
https://qwen-image.mcp.acedata.cloud/mcp
OpenAI Tools MCP ServerB
ai.com.mcp
Focused MCP server for OpenAI image/audio generation (v2.0.0). Wraps endpoints via HAPI CLI.
Image & Video Processing Audio Processing Multimedia Processing
927
https://openai-tools.run.mcp.com.ai/mcp
mcp-veo
io.github.AceDataCloud
MCP server for Google Veo AI video generation
Multimedia Processing Image & Video Processing Entertainment & Media
23
https://veo.mcp.acedata.cloud/mcp
mcp-hailuo
io.github.AceDataCloud
MCP server for Hailuo (MiniMax) AI video generation
AI & Machine Learning Image & Video Processing
21
https://hailuo.mcp.acedata.cloud/mcp

Related MCP Servers

jgkme/kilo-image-gen-mcp
Image & Video Processing AI & Machine Learning
jgkme
A
license
Not graded
quality
C
maintenance
MCP server for generating, editing, and processing images via multiple providers including Kilo, OpenRouter, OpenAI, and Gemini, with local tools for background removal, resizing, and cropping.
Updated 4 months ago (2026-07-07 14:48 UTC)
57 npm
3
MIT
nano-banana-claude
AI & Machine Learning Image & Video Processing
tougenrip
A
license
Not graded
quality
D
maintenance
An MCP server that provides image generation using Google's Nano Banana Gemini models, with additional tools for background removal, upscaling, and format conversion via deterministic post-processing.
Updated 5 months ago (2026-06-09 18:15 UTC)
1
MIT
Nano Banana MCP
AI & Machine Learning Image & Video Processing
jiwon86
F
license
A
quality
D
maintenance
Wraps Google Gemini's image generation API as an MCP server, enabling text-to-image, image editing, and grounded search workflows from any MCP client.
Updated 7 months ago (2026-03-25 06:17 UTC)
2
-
Nano Banana MCP
AI & Machine Learning Image & Video Processing
Maheidem
A
license
Not graded
quality
D
maintenance
MCP server for Google's Nano Banana image generation models (Gemini). Generate and edit images via natural language.
Updated 8 months ago (2026-03-10 17:20 UTC)
12 npm
1
MIT

mcp-alphabanana

Inicio rápido

Registro de Claude

Servidor MCP

Herramientas disponibles

generate_image

Selección de modelo

Parámetros

¿Por qué alphabanana?

Características

Ejemplos de salida

Configuración

Integración con VS Code

Ejemplos de uso

Generación básica

Tamaño nativo sin cambio de tamaño

Avanzado (Póster vertical y pensamiento)

Muestra de fundamentación (respaldada por búsqueda)

Con imágenes de referencia

Transparencia y formatos de salida

Desarrollo

Licencia

Available Tools

TDQS

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

jgkme/kilo-image-gen-mcp

nano-banana-claude

Nano Banana MCP

Nano Banana MCP