Banana Image

npm version npm downloads License: MIT Node.js Version MCP

中文文档

An MCP (Model Context Protocol) server for image generation, processing, and CDN upload. Powered by Google Gemini AI, Sharp, and Qiniu Cloud.

Features

• Generate images from text prompts using Google Gemini AI
• Upload local or remote images to Qiniu CDN
• Automatic conversion to WebP format with compression
• Date-prefixed filenames with customizable upload paths
• 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"
      }
    }
  }
}

Upgrade

# npx users: just clear the cache to get the latest version
npx clear-npx-cache && npx -y banana-image-mcp

# Global installation users
npm update -g banana-image-mcp

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:

1. Visit Google AI Studio
2. Create or get an API key

Qiniu Cloud:

1. Register at Qiniu Cloud
2. Create a storage bucket
3. Get AccessKey and SecretKey from your account settings
4. Configure a CDN domain

Tools

generate_blog_cover

Generate a blog cover image (1792x1024), convert to WebP, and upload to Qiniu CDN.

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:

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

generate_image

Generate an image using Gemini AI (original size), convert to WebP, and upload to Qiniu CDN.

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: aigc/image)

Returns:

{
  "url": "https://your-cdn-domain.com/aigc/image/20260321-my-image.webp"
}

upload_image

Upload a local file or remote URL image to Qiniu CDN, with automatic WebP conversion.

Parameter	Type	Required	Description
source	string	Yes	Local file path or HTTP/HTTPS URL of the image
slug	string	Yes	Slug identifier for the filename (prefixed with date)
path	string	No	Upload directory path (default: images)

Returns:

{
  "url": "https://your-cdn-domain.com/images/20260321-my-photo.webp"
}

Architecture

prompt → Google Gemini API (PNG) → Sharp (WebP) → Qiniu CDN → URL
source (local/remote) ─────────→ Sharp (WebP) → Qiniu CDN → URL

• Image generation: Google Gemini 3.1 Flash Image Preview
• Image processing: Sharp (WebP conversion, optional resize)
• Cloud storage: Qiniu CDN

License

MIT