mcp-image

media MCP Server

MCP server for AI image generation and editing with automatic prompt optimization and quality presets. Powered by Gemini (Nano Banana 2 & Pro), with optional OpenAI GPT Image support.

Install Ready
mediamedia
10 views119 stars19 forksv0.11.2MIT

Why This Matters

Discovered via unknown and last synced 3mo ago.

Install Ready
Source
unknown
Stars
119
Last synced
3mo ago
Install
Instructions detected

Install

1. Install the package

npx -y mcp-image

2. Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "mcp-image"
      ]
    }
  }
}

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

18
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (18)

quality

string

Type

Required

aspectRatio

string

imageSize

string

inputImagePath

string

balanced

Nano Banana 2 + Thinking

Preset

Model

Default

Description

IMAGE_PROVIDER

`gemini`

Parameter

Type

prompt

string

fileName

string

blendImages

boolean

maintainCharacterConsistency

boolean

useWorldKnowledge

boolean

useGoogleSearch

boolean

purpose

string

Slow

Set the default via `IMAGE_QUALITY` environment variable: ``` IMAGE_QUALITY=fast # (default) Fastest generation IMAGE_QUALITY=balanced # Enhanced thinking for better quality IMAGE_QUALITY=quality # Maximum quality output ``` To override per-request, just tell your AI assistant (e.g., "generate in high quality" or "use balanced quality"). The assistant will pass the appropriate `quality` parameter automatically. **Codex:** ```toml [mcp_servers.mcp-image.env] GEMINI_API_KEY = "your_gemini_api_key_here" IMAGE_QUALITY = "balanced" ``` **Cursor:** Add `"IMAGE_QUALITY": "balanced"` to the env section in your config. **Claude Code:** ```bash claude mcp add mcp-image --env GEMINI_API_KEY=your-api-key --env IMAGE_QUALITY=balanced --env IMAGE_OUTPUT_DIR=/absolute/path/to/images -- npx -y mcp-image ``` ### Skip Prompt Enhancement Set `SKIP_PROMPT_ENHANCEMENT=true` to disable automatic prompt optimization and send your prompts directly to the image generator. Useful when you need full control over the exact prompt wording. ### Provider Configuration