Skip to main content
Glama
daanjonk

kie-ai-mcp-server

by daanjonk
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Remote

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.2

  • GPT Image 2 Text-to-Image (gpt-image-2-text-to-image) — OpenAI GPT Image 2 text-to-image. High-quality generation from text prompts with broad aspect-ratio support.

  • GPT Image 2 Image-to-Image (gpt-image-2-image-to-image) — Transform or extend one or more reference images with a natural-language prompt.

Previously 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.

Related MCP server: universal-image-mcp

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

gpt-image-2-text-to-image

GPT Image 2

OpenAI GPT Image 2. Broad aspect-ratio support

gpt-image-2-image-to-image

GPT Image 2 I2I

Transform/extend up to 8 reference images

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/daanjonk/kie-ai-mcp-v1.git
cd kie-ai-mcp-v1
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

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityStale
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers