banana-image-mcp

An MCP (Model Context Protocol) server for generating blog cover images using Google Gemini AI, with automatic WebP conversion and Qiniu CDN upload.

Features

Generate images from text prompts using Google Gemini AI
Automatic conversion to WebP format (1792x1024, 80% quality)
Upload to Qiniu CDN with date-prefixed filenames
Customizable upload directory
Temporary files are cleaned up automatically

Quick Start

Using npx (recommended)

No installation needed — configure directly in your MCP client:

{
  "mcpServers": {
    "banana-image": {
      "command": "npx",
      "args": ["-y", "banana-image-mcp"],
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key",
        "QINIU_ACCESS_KEY": "your-qiniu-access-key",
        "QINIU_SECRET_KEY": "your-qiniu-secret-key",
        "QINIU_BUCKET": "your-bucket-name",
        "QINIU_CDN_DOMAIN": "https://your-cdn-domain.com"
      }
    }
  }
}

Global installation

npm install -g banana-image-mcp

Then configure in your MCP client:

{
  "mcpServers": {
    "banana-image": {
      "command": "banana-image-mcp",
      "env": {
        "GEMINI_API_KEY": "your-gemini-api-key",
        "QINIU_ACCESS_KEY": "your-qiniu-access-key",
        "QINIU_SECRET_KEY": "your-qiniu-secret-key",
        "QINIU_BUCKET": "your-bucket-name",
        "QINIU_CDN_DOMAIN": "https://your-cdn-domain.com"
      }
    }
  }
}

Configuration file location

Claude Desktop (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json
Claude Desktop (Windows): %APPDATA%\Claude\claude_desktop_config.json

Environment Variables

Variable	Description
`GEMINI_API_KEY`	Google Gemini API key for image generation
`QINIU_ACCESS_KEY`	Qiniu cloud access key
`QINIU_SECRET_KEY`	Qiniu cloud secret key
`QINIU_BUCKET`	Qiniu storage bucket name
`QINIU_CDN_DOMAIN`	CDN domain for generated image URLs

Getting API Keys

Google Gemini API Key:

Visit Google AI Studio
Create or get an API key

Qiniu Cloud:

Register at Qiniu Cloud
Create a storage bucket
Get AccessKey and SecretKey from your account settings
Configure a CDN domain

Tool

`generate_blog_cover`

Generate a blog cover image, convert to WebP, and upload to Qiniu CDN.

Parameters:

Parameter	Type	Required	Description
`prompt`	string	Yes	Text prompt describing the image to generate
`slug`	string	Yes	Slug identifier for the filename (prefixed with date)
`path`	string	No	Upload directory path (default: `blog-cover`)

Returns: JSON with the CDN URL of the uploaded image.

{
  "url": "https://your-cdn-domain.com/blog-cover/20260318-my-post.webp"
}

Architecture

prompt → Google Gemini API (PNG) → Sharp (WebP) → Qiniu CDN → URL

Image generation: Google Gemini 3.1 Flash Image Preview
Image processing: Sharp (resize to 1792x1024, WebP at 80% quality)
Cloud storage: Qiniu CDN

License

MIT

Banana Image MCP