Log inSubmit server
MCP Alphabanana logo

MCP Alphabanana

by tasopen

Generates Gemini image assets locally through MCP with resizing, transparency, references, and file or encoded outputs.

InstallRepository
Full README Compare alternatives Embed widget Claim this listing

Install MCP Alphabanana

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "tasopen-mcp-alphabanana": {
      "command": "npx",
      "args": [
        "-y",
        "@tasopen/mcp-alphabanana"
      ],
      "env": {
        "GEMINI_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y @tasopen/mcp-alphabanana

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 29d ago.

Overview

The tasopen/mcp-alphabanana MCP server generates image assets through Google Gemini from an MCP-compatible client. It supports Flash, Lite, and Pro model options, configurable output sizes and formats, local reference images, transparent PNG/WebP processing, and file, base64, or combined responses. Use it when an agent needs generated artwork or production-oriented image files without leaving the MCP workflow. A Gemini API key is required.

Use cases

  • Generate game sprites and visual assets
  • Create transparent PNG or WebP images
  • Guide image generation with local references
  • Save exact-size images for web pipelines
  • Return generated images as files or base64 data

Key features

  • Google Gemini image generation
  • Flash, Lite, and Pro model selection
  • Transparent PNG/WebP processing
  • Up to 14 local reference images
  • Exact resizing and multiple resize modes
  • File, base64, or combined output

Tools7

What MCP Alphabanana lets your agent do. Expand a tool for its parameters.

Self-reported~98 tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

8/9 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 9d ago via OSV.dev · @tasopen/mcp-alphabanana (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars10Stargazers on the source repository.
npm downloads471Package downloads in the last 30 days.
Last commit19d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Tools exposed7Callable tools this server registers over MCP.
Directory activity5 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Alphabanana works

What tasopen/mcp-alphabanana MCP server does

The tasopen/mcp-alphabanana MCP server exposes a generate_image tool for creating image assets with Google Gemini. An agent supplies a prompt and output settings, then receives either a saved file, encoded image data, or both. The tool is suited to workflows that generate illustrations, game assets, visual drafts, or other raster images from natural-language instructions.

Several Gemini image model choices are available. Flash3.1 is the default and supports thinking and grounding controls; Lite3.1 is limited to 1K output; Flash2.5 provides a legacy Flash option; and Pro3 targets higher-fidelity generation. flash and pro remain available as aliases.

How it works

The server runs locally and sends generation requests to Google Gemini using the configured API key. The request can specify a prompt, model, output resolution, dimensions, aspect ratio, format, resize behavior, and delivery mode. Normal mode resizes the generated result to outputWidth and outputHeight. With noresize=true, the response keeps Gemini’s native dimensions and requires both an aspectRatio and output_resolution value.

Generated images can be returned as PNG, JPG, or WebP. File and combined responses require an absolute outputPath; base64 responses place the image data in the MCP result. For Claude Desktop, file output is recommended for medium or large images because base64 and combined responses can consume substantial client context.

Local reference files can guide the generation. The tool accepts up to 14 references for the newer supported models and up to three for Flash2.5. Flash3.1 can also use text or image grounding and can include reasoning or grounding metadata when those options are enabled. Lite3.1 does not support Search Grounding.

Setup and configuration

Install and start the tasopen/mcp-alphabanana MCP server with npx -y @tasopen/mcp-alphabanana. Set GEMINI_API_KEY in the MCP client environment before launching it. The same variable can be mapped from the operating system environment in an MCP configuration, or supplied directly in that configuration.

The repository also provides an MCPB download for Claude Desktop. Claude Desktop users can add the downloaded package as an extension. On Windows, the documentation recommends adding a FileSystem extension when the workflow needs to select local reference files or writable output paths. Cursor and VS Code are also listed as compatible MCP clients.

Tools and capabilities

The single exposed tool, generate_image, supports:

  • Model selection across Lite, Flash, and Pro variants.
  • 0.5K, 1K, 2K, and 4K resolution settings where supported.
  • Exact width and height output with crop, stretch, letterbox, or contain resizing.
  • PNG, JPG, and WebP output.
  • Transparent PNG or WebP post-processing with configurable color tolerance and fringe handling.
  • File, base64, or combined delivery.
  • Up to 14 local reference images for supported models.
  • Optional Flash3.1 thinking, grounding, reasoning fields, and metadata.

The outputFileName parameter is required, and its extension can be added automatically when omitted. Debug mode can save intermediate artifacts. Transparency processing is intended for PNG and WebP; JPG does not support an alpha channel.

Limitations and notes

The server depends on Google Gemini access and a valid GEMINI_API_KEY; the repository does not describe a built-in free generation service. Model features vary, so grounding and thinking controls should be used with Flash3.1, while Lite3.1 is restricted to 1K output and has no Search Grounding.

Large encoded responses may exceed an MCP client’s context limits, making file output a better choice for larger assets. Reference images must be local files, and output directories must be writable absolute paths. The project is released under the MIT license. The tasopen/mcp-alphabanana MCP server is therefore most appropriate when the client can access local files and the workflow can provide Google Gemini credentials.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Alphabanana

Run `npx -y @tasopen/mcp-alphabanana` and configure `GEMINI_API_KEY` in the MCP client environment.

Yes. The repository provides an MCPB package for Claude Desktop, and the server can also be configured with npx.

It requires a Google Gemini API key supplied through the `GEMINI_API_KEY` environment variable.

Yes. Enable transparent output for PNG or WebP generation; the server applies transparency post-processing.

It supports up to 14 local reference images for supported newer models and up to three for Flash2.5.

Related MCP servers

All in Multimedia Process All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Alphabanana AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/tasopen-mcp-alphabanana?style=directory)](https://allmcps.com/mcp/tasopen-mcp-alphabanana)
HTML Embed
<a href="https://allmcps.com/mcp/tasopen-mcp-alphabanana"><img src="https://allmcps.com/api/badge/tasopen-mcp-alphabanana?style=directory" alt="MCP Alphabanana on AllMCPs" /></a>