Kie AI MCP Server

Universal MCP server for all Kie AI image generation and editing models. One server, every model — pick the one you want at call time.

What's New in v2.1

• Seedream 5 Lite Text-to-Image (seedream/5-lite-text-to-image) — ByteDance's latest lightweight generation model with high-quality output by default.
• Seedream 5 Lite Image-to-Image (seedream/5-lite-image-to-image) — Transform existing images with natural language. Change lighting, styles, effects, and more. Defaults to high quality output.

Supported Models

Generation (text-to-image / image-to-image)

Model ID	Name	Highlights
nano-banana-pro	Nano Banana Pro	Best all-around. 4K, text rendering, up to 8 ref images
google/nano-banana	Nano Banana	Fast, affordable Gemini-based generation
nano-banana-2	Nano Banana 2	Second-gen improvements
seedream/5-lite-text-to-image	Seedream 5 Lite	ByteDance's latest. High quality by default
seedream/5-lite-image-to-image	Seedream 5 Lite I2I	Transform images with natural language. High quality default
seedream/4.5-text-to-image	Seedream 4.5	ByteDance. Photorealistic, 2K/4K quality modes
flux-2/pro-text-to-image	Flux 2 Pro	Photoreal detail, accurate text rendering
flux-2/pro-image-to-image	Flux 2 Pro I2I	Style transfer, outfit changes, up to 8 refs
flux-2/flex-text-to-image	Flux 2 Flex	Good quality/cost ratio
flux-2/flex-image-to-image	Flux 2 Flex I2I	Flexible transformations, lower cost
flux-1/kontext	Flux 1 Kontext	Context-aware generation
imagen-4	Imagen 4	Google's latest, excellent fidelity
ideogram/v3	Ideogram V3	Best-in-class text/typography in images
ideogram/character	Ideogram Character	Consistent character generation
4o-image	4o Image	OpenAI 4o-based generation
z-image	Z-Image	Alternative generation model

Editing (image-edit)

Model ID	Name	Highlights
seedream/4.5-edit	Seedream 4.5 Edit	Material, lighting, style changes. 4K output
google/nano-banana-edit	Nano Banana Edit	Gemini-based editing. Fast and cheap
qwen/image-edit	Qwen Image Edit	Alibaba's general-purpose editor

Tools

Tool	Description
kie_list_models	List all available models with capabilities and parameters
kie_generate_image	Generate an image (text-to-image or image-to-image)
kie_edit_image	Edit an existing image with natural language
kie_get_task_status	Check task status and get result URLs

Quick Start (npx — no install needed)

1. Get your API key

Go to kie.ai/api-key and create an API key.

2. Add to Claude Desktop / Claude Code

Add this to your MCP settings (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "kie-ai": {
      "command": "npx",
      "args": ["-y", "kie-ai-mcp-server"],
      "env": {
        "KIE_AI_API_KEY": "your_api_key_here"
      }
    }
  }
}

That's it. npx downloads and runs the server automatically — no cloning, no building.

Alternative: Install from source

git clone https://github.com/spiritbird-ai/kie-ai-mcp-server.git
cd kie-ai-mcp-server
npm install
npm run build

Then use this config instead:

{
  "mcpServers": {
    "kie-ai": {
      "command": "node",
      "args": ["/path/to/kie-ai-mcp-server/dist/index.js"],
      "env": {
        "KIE_AI_API_KEY": "your_api_key_here"
      }
    }
  }
}

Usage Examples

Generate an image

Use kie_generate_image with model "nano-banana-pro", prompt "A cozy coffee shop interior with warm lighting, watercolor style", aspect_ratio "16:9", resolution "2K"

Edit an image

Use kie_edit_image with model "seedream/4.5-edit", prompt "Change the background to a tropical beach at sunset", image_urls ["https://example.com/my-photo.jpg"]

Check task status

Use kie_get_task_status with task_id "abc123..."

Environment Variables

Variable	Required	Default	Description
KIE_AI_API_KEY	Yes	—	Your Kie AI API key
KIE_AI_BASE_URL	No	https://api.kie.ai/api/v1	API base URL
KIE_AI_TIMEOUT	No	60000	Request timeout in ms

How It Works

All Kie AI models share the same API pattern:

1. Create task: POST /jobs/createTask with { model, input }
2. Poll status: GET /jobs/recordInfo?taskId=...
3. Get result: When state === "success", the result URLs are in resultJson

This server wraps that pattern into clean MCP tools with model-specific parameter validation.

Adding New Models

To add a new Kie AI model, simply add an entry to the MODEL_REGISTRY array in src/models.ts. No other changes needed — the tools dynamically adapt to the registry.

License

MIT