Skip to main content
Glama
mcp-alphabanana

mcp-alphabanana

by tasopen

mcp-alphabanana

npm version License: MIT

English | 日本語

mcp-alphabanana — это сервер протокола Model Context Protocol (MCP) для генерации изображений с помощью Google Gemini. Он создан для MCP-совместимых клиентов и агентских рабочих процессов, которым требуется быстрая генерация изображений, прозрачный вывод, использование референсных изображений и гибкие форматы доставки.

Ключевые слова: MCP-сервер, Model Context Protocol, Gemini AI, генерация изображений, FastMCP

Основные возможности:

  • Сверхбыстрая генерация изображений Gemini в версиях Flash и Pro

  • Вывод ресурсов в форматах PNG/WebP с прозрачностью для веб-разработки и игровых конвейеров

  • Управление стилем с помощью нескольких локальных референсных изображений

  • Гибкие варианты вывода: файл, base64 или комбинированный для агентских рабочих процессов

демо alphabanana

Быстрый старт

Запустите MCP-сервер с помощью npx:

npx -y @tasopen/mcp-alphabanana

Или добавьте его в свою конфигурацию MCP:

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

Установите GEMINI_API_KEY перед запуском сервера.

Для Claude Desktop: Скачайте mcp-alphabanana-latest.mcpb, затем добавьте его как расширение в настройках Claude Desktop. Для Windows рекомендуется добавить расширение 'FileSystem' для более удобной работы с локальными файлами. Скачать MCPB

Related MCP server: nano-banana-claude

Реестр Claude

Метаданные реестра Claude / пакета MCPB определены в manifest.json и поставляются со статичным значком 512x512 по адресу images/mcp-alphabanana.png.

Собственные пакеты среды выполнения sharp объявлены как необязательные зависимости, чтобы установки .mcpb могли разрешать правильный предварительно скомпилированный бинарный файл на каждой поддерживаемой платформе без использования хуков postinstall.

  • Стабильный URL MCPB: https://github.com/tasopen/mcp-alphabanana/releases/latest/download/mcp-alphabanana-latest.mcpb

  • Шаблон версионного URL MCPB: https://github.com/tasopen/mcp-alphabanana/releases/download/vVERSION/mcp-alphabanana-VERSION.mcpb

  • Поддержка: GitHub Issues

MCP-сервер

Этот репозиторий предоставляет MCP-сервер, который позволяет ИИ-агентам генерировать изображения с помощью Google Gemini.

Его можно использовать с MCP-совместимыми клиентами, такими как:

  • Claude Desktop

  • VS Code MCP

  • Cursor

Создан с использованием FastMCP 3 для упрощения кодовой базы и гибких параметров вывода.

Бейдж Glama MCP Server:\

Доступные инструменты

generate_image

Генерирует изображения с помощью Google Gemini с поддержкой прозрачности, локальных референсных изображений, поиска (grounding) и метаданных рассуждений.

Для Claude Desktop предпочтительнее использовать outputType=file для изображений среднего или большого размера. Ответы base64 и combine потребляют контекст Claude и могут достичь лимита размера клиента. В Windows используйте расширение FileSystem, чтобы выбрать записываемый абсолютный путь outputPath и любые локальные пути referenceImages.

Основные параметры:

  • prompt (строка): описание изображения для генерации

  • model: Flash3.1, Flash2.5, Pro3, flash, pro

  • outputWidth и outputHeight: требуемый итоговый размер изображения в пикселях в обычном режиме

  • noresize + aspectRatio + output_resolution: возврат исходного размера Gemini без изменения размера

  • output_resolution: 0.5K, 1K, 2K, 4K

  • output_format: png, jpg, webp

  • outputType: file, base64, combine

  • outputPath: обязательно, если outputType равен file или combine

  • transparent: включить постобработку прозрачности PNG/WebP

  • referenceImages: необязательный массив локальных референсных изображений

  • grounding_type и thinking_mode: расширенные элементы управления Gemini 3.1

Выбор модели

ID входной модели

ID внутренней модели

Описание

Flash3.1

gemini-3.1-flash-image-preview

Сверхбыстрая, поддерживает Thinking/Grounding.

Flash2.5

gemini-2.5-flash-image

Устаревшая Flash. Высокая стабильность. Низкая стоимость.

Pro3

gemini-3.0-pro-image-preview

Высокоточная модель Pro.

flash

gemini-3.1-flash-image-preview

Псевдоним для обратной совместимости.

pro

gemini-3.0-pro-image-preview

Псевдоним для обратной совместимости.

Параметры

Полный справочник параметров для инструмента generate_image.

Параметр

Тип

По умолчанию

Описание

prompt

строка

обязательно

Описание изображения для генерации

outputFileName

строка

обязательно

Имя выходного файла (расширение добавляется автоматически, если отсутствует)

outputType

enum

combine

file, base64 или combine

model

enum

Flash3.1

Модель: Flash3.1, Flash2.5, Pro3, flash, pro

output_resolution

enum

auto

0.5K, 1K, 2K, 4K; обязательно, если noresize=true

noresize

boolean

false

Пропустить изменение размера после генерации и вернуть исходные размеры Gemini

aspectRatio

enum

необязательно

Обязательно, если noresize=true; например, 1:1, 16:9, 4:5

outputWidth

integer

обязательно, если не noresize=true

Итоговая ширина вывода в пикселях

outputHeight

integer

обязательно, если не noresize=true

Итоговая высота вывода в пикселях

output_format

enum

png

png, jpg, webp

outputPath

строка

обязательно для file / combine

Абсолютный путь к директории вывода

transparent

boolean

false

Прозрачный фон (только PNG/WebP)

transparentColor

строка или null

null

Переопределение цветового ключа для извлечения прозрачности

colorTolerance

integer

30

Допуск соответствия цвета прозрачности

fringeMode

enum

auto

auto, crisp, hd

resizeMode

enum

crop

crop, stretch, letterbox, contain

grounding_type

enum

none

none, text, image, both (только Flash3.1)

thinking_mode

enum

minimal

minimal, high (только Flash3.1)

include_thoughts

boolean

false

Возвращать поля рассуждений модели, если включены метаданные

include_metadata

boolean

false

Включать метаданные поиска и рассуждений в JSON-вывод

referenceImages

массив

[]

До 14 локальных референсных файлов (Flash3.1/Pro3), 3 для Flash2.5

debug

boolean

false

Сохранять промежуточные отладочные артефакты

Почему alphabanana?

  • Без водяных знаков: Чистые изображения, созданные API.

  • Поддержка Thinking/Grounding: Более точное следование промпту и точность, подкрепленная поиском.

  • Готовность к продакшену: Поддержка прозрачного WebP и точных соотношений сторон для веб-ресурсов и игровых ассетов.

Функции

  • Сверхбыстрая генерация изображений (Gemini 3.1 Flash, 0.5K/1K/2K/4K)

  • Расширенное рассуждение по нескольким изображениям (до 14 референсных изображений)

  • Поддержка Thinking/Grounding (только Flash3.1)

  • Вывод прозрачных PNG/WebP (постобработка цветового ключа, удаление ореолов)

  • Несколько форматов вывода: файл, base64 или оба

  • Гибкие режимы изменения размера: обрезка, растяжение, letterbox, contain

  • Несколько уровней моделей: Flash3.1, Flash2.5, Pro3, устаревшие псевдонимы

Примеры вывода

Эти примеры вывода были сгенерированы с помощью mcp-alphabanana и сохранены в images/examples.

Пиксель-арт ассет

Игровая сцена с референсом

Фотореалистичная генерация

Пиксель-арт сундук с сокровищами

Сцена с лутом в подземелье

Фотореалистичный постер путешествия

Конфигурация

Настройте GEMINI_API_KEY в вашей конфигурации MCP (например, mcp.json).

Примеры:

  • Ссылка на переменную окружения ОС из mcp.json:

{
  "env": {
    "GEMINI_API_KEY": "${env:GEMINI_API_KEY}"
  }
}
  • Указание ключа напрямую в mcp.json:

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

Интеграция с VS Code

Добавьте в настройки VS Code (.vscode/settings.json или настройки пользователя), настроив env сервера в mcp.json или через настройки VS Code MCP.

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

Необязательно: Установите пользовательскую резервную директорию для сбоев записи, добавив MCP_FALLBACK_OUTPUT в объект env.

Примеры использования

Базовая генерация

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

Исходный размер без изменения размера

{
  "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"
}

Этот режим возвращает исходный размер в пикселях Gemini для запрошенного соотношения и разрешения. Например, 1:1 + 0.5K возвращает 512x512 без прохода изменения размера.

Расширенный (вертикальный постер и мышление)

{
  "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
}

Пример Grounding (с поиском)

{
  "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
}

Этот пример включает поиск в Google и возвращает метаданные поиска и рассуждений в формате JSON.

С референсными изображениями

{
  "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"
    }
  ]
}

Прозрачность и форматы вывода

  • PNG: Полная альфа, цветовой ключ + удаление ореолов

  • WebP: Полная альфа, лучшее сжатие (Flash3.1+)

  • JPEG: Без прозрачности (заменяется сплошным фоном)

Разработка

# Development mode with MCP CLI
npm run dev

# MCP Inspector (Web UI)
npm run inspect

# Build for production
npm run build

Лицензия

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.

NameRequiredDescriptionDefault
debugNoDebug mode: output intermediate processing images and prompt
modelNoModel 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
promptYesUser-provided image prompt. Preserve the original wording and detail; do not summarize or translate. Only append transparency-related hints if needed.
noresizeNoSkip post-generation resizing and return Gemini native dimensions directly. When true, provide aspectRatio and output_resolution instead of outputWidth/outputHeight.
fringeModeNoFringe reduction mode: auto (size-based), crisp (binary alpha), hd (force-clear 1px boundary for large images).auto
outputPathNoOutput 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.
outputTypeNoOutput 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
resizeModeNoResize mode: crop=center crop, stretch=distort, letterbox=fit with padding, contain=trim transparent margins then fitcrop
aspectRatioNoGemini aspect ratio to use directly when noresize=true. Ignored in normal resize mode.
outputWidthNoOutput 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.
transparentNoRequest transparent background (PNG or WebP only). Background color is selected by histogram analysis.
outputHeightNoOutput 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_formatNoOutput formatpng
thinking_modeNoThinking 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
colorToleranceNoTolerance for color matching (0-255). Higher values are more permissive for transparent color selection and keying.
grounding_typeNoGrounding tool usage (requires a grounding-capable model; see [Model Guidance] in the tool description)none
outputFileNameYesOutput filename (extension auto-added if missing)
referenceImagesNoReference images for style guidance (max 14 files; per-model limits are enforced automatically)
include_metadataNoInclude grounding and reasoning metadata in JSON output (optional, may increase payload size).
include_thoughtsNoOptional (default: false). Request thought fields from Gemini (thinking-capable models only). Thought content is returned in MCP response only when include_metadata=true.
transparentColorNoColor to make transparent. Hex (e.g. #FF00FF). null defaults to #FF00FF when transparent=true.
output_resolutionNoGemini 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. 1 tool updatev1.6.0
    • 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"
        +]
  2. 1 tool updatev1.5.0
    • 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"
        +]
  3. 1 tool updatev1.3.6
    • First observedgenerate_image

TDQS

A4.4/5.0

Scored 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

ActivityNo data
ResponsivenessSyncing

Related MCP Connectors

Related MCP Servers