Skip to main content
Glama

KieAI MCP — KI-Mediengeneration via kie.ai

MCP-Server für KI-gestützte Mediengeneration: Bilder, Videos, Audio und Upscaling mit 99 KI-Modellen — lokal via Claude Code oder remote via Docker/Coolify.

Features

  • 99 KI-Modelle — Bilder, Videos, Audio, Upscaling

  • Zwei Transport-Modi — stdio (lokal) und HTTP/SSE (remote)

  • YAML-basierte Modellkonfiguration — neue Modelle ohne Code hinzufügen

  • Automatisches Polling — wartet auf Ergebnisse asynchroner Generierungen

  • Docker-ready — einfaches Deployment via Docker oder Coolify

Related MCP server: Gemini Media MCP

Quick Start

Lokal (stdio) — Als Claude Code Plugin

# Plugin installieren
claude mcp add kie-ai-mcp -- bun run /pfad/zu/kie-ai-plugin/src/index.ts

# API Key setzen
export KIE_API_KEY="dein-kie-ai-api-key"

Remote (HTTP/SSE) — Docker Deployment

# Image bauen
docker build -t kie-ai-mcp .

# Container starten
docker run -e KIE_API_KEY=dein-key -e MCP_TRANSPORT=http -p 3001:3001 kie-ai-mcp

# Health Check
curl http://localhost:3001/health

Konfiguration

  1. Account auf kie.ai erstellen

  2. API Key generieren unter https://kie.ai/api-key

  3. Key als Umgebungsvariable setzen:

export KIE_API_KEY="dein-kie-ai-api-key"

Variable

Beschreibung

Default

KIE_API_KEY

API Key von kie.ai

— (Pflicht)

MCP_TRANSPORT

Transport-Modus: stdio oder http

stdio

PORT

Port für HTTP/SSE-Modus

3001

Verfügbare Modelle

Bilder (7 Modelle)

Modell

Stärke

Kosten

Flux 2 Pro

Allrounder, bis 2K

~$0.03

Seedream 3.0

Text-Rendering

~$0.02

Google Imagen 4

Negative Prompts

~$0.04

Ideogram Character

Referenz-Bilder

~$0.05

Qwen

Viele Parameter

~$0.02

Grok Imagine

Kreativ (nur EN)

~$0.03

Z-Image

Fotorealistisch

~$0.01

Videos (6 Modelle)

Modell

Typ

Max Dauer

Kosten

Sora 2 Pro

Text-to-Video

15s

~$2.00

ByteDance V1

Text-to-Video

10s

~$0.40

Grok Video

Text-to-Video

15s

~$0.50

Kling V2.1

Image-to-Video

10s

~$0.30

Wan 2.6

Image-to-Video

15s

~$0.35

Hailuo 2.3

Image-to-Video

10s

~$0.40

Audio (1 Modell)

Modell

Typ

Kosten

ElevenLabs TTS

Text-to-Speech

~$0.01

Upscaling (2 Modelle)

Modell

Max Faktor

Kosten

Topaz

8x

~$0.05

Recraft Crisp

Auto

~$0.03

Transport-Modi

stdio (Standard)

Für die lokale Integration mit Claude Code. Der MCP-Server kommuniziert über stdin/stdout direkt mit Claude Code. Generierte Dateien werden lokal gespeichert.

# Automatisch bei Plugin-Nutzung via Claude Code
claude mcp add kie-ai-mcp -- bun run /pfad/zu/kie-ai-plugin/src/index.ts

HTTP/SSE (Remote)

Für Remote-Nutzung via Docker oder Coolify. Der Server stellt einen HTTP-Endpoint mit Server-Sent Events bereit.

Wichtig: Im HTTP-Modus werden nur Result-URLs zurückgegeben — es findet kein lokaler File-Download statt.

MCP_TRANSPORT=http PORT=3001 bun run src/index.ts

Docker

Image bauen

docker build -t kie-ai-mcp .

Container starten

docker run \
  -e KIE_API_KEY=dein-api-key \
  -e MCP_TRANSPORT=http \
  -p 3001:3001 \
  kie-ai-mcp

Health Check

curl http://localhost:3001/health

Coolify Deployment

  1. GitHub Repo verbinden — Repository in Coolify als neue Ressource hinzufügen

  2. Umgebungsvariablen setzen:

    • KIE_API_KEY — Dein kie.ai API Key

    • MCP_TRANSPORT — auf http setzen

    • PORT3001 (oder nach Bedarf)

  3. Domain zuweisen — Über die Coolify-Oberfläche eine Domain konfigurieren (z.B. kie-mcp.deine-domain.de)

  4. Deployen — Build starten, Coolify nutzt automatisch das Dockerfile

Remote MCP Client Konfiguration

Um einen MCP-Client mit dem remote deployten Server zu verbinden:

{
  "mcpServers": {
    "kie-ai-mcp": {
      "url": "https://kie-mcp.deine-domain.de/sse"
    }
  }
}

Nutzung

Bilder erstellen

"Erstelle ein Bild von einem Sonnenuntergang am Meer"
"Generiere ein fotorealistisches Portrait mit Flux 2"
"Mach ein Bild mit Text 'Hello World' — nutze Seedream"

Videos erstellen

"Erstelle ein Video von tanzenden Katzen"
"Animiere dieses Bild [URL] mit Kling"
"Generiere ein 10-Sekunden Video eines Wasserfalls"

Audio erstellen

"Lies diesen Text vor: Willkommen bei Alice"
"Text to Speech auf Deutsch: Guten Morgen Oliver"

Bilder hochskalieren

"Skaliere dieses Bild hoch: [URL]"
"Upscale mit 4x Faktor"

Neues Modell hinzufügen

  1. YAML-Datei in models/{type}/ erstellen

  2. Fertig — kein Code nötig

Entwicklung

bun install        # Dependencies
bun test           # Tests (61 Tests)
bun run build      # TypeScript kompilieren
bun run dev        # Watch Mode

Lizenz

MIT

Available Tools

6 tools
kie_check_taskB

Check the status of a kie.ai generation task

ParametersJSON Schema
NameRequiredDescriptionDefault
task_idYesThe task ID to check

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It only states the action without detailing possible statuses, return format, polling semantics, or error behavior. The word 'check' suggests a read operation, but no additional context is given, leaving the agent uncertain about the tool's exact behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, concise sentence that front-loads the action and resource. It contains no unnecessary information or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

While the tool is simple with one parameter and no output schema, the description still lacks important context such as when to use it in the generation workflow and what the response contains. The absence of an output schema makes the missing return value explanation a notable gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema provides 100% coverage for the single parameter with a clear description ('The task ID to check'). The tool description adds no further parameter meaning, so the baseline score of 3 applies due to high schema coverage.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies the action (check status) and resource (a kie.ai generation task), distinguishing it from sibling tools that generate, upscale, or list models. It uses a specific verb and resource, making the purpose unmistakable.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No explicit guidance on when to use this tool is provided, but the sibling context (generation, upscale, list models) implies it is used after submitting a generation task. This is implied rather than directly stated, so it earns a baseline score.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kie_generate_audioA

Generate audio (text-to-speech) using AI models via kie.ai

ParametersJSON Schema
NameRequiredDescriptionDefault
textYesText to convert to speech
modelNoModel ID for audio generationelevenlabs/text-to-speech-turbo-2-5
speedNoSpeech speed multiplier
voiceNoVoice name to useRachel
filenameNoCustom filename (without extension)
stabilityNoVoice stability (0.0 - 1.0)
output_dirNoOutput directory./audio
language_codeNoLanguage code (e.g. 'en', 'de')

TDQS

A3.6/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It only says 'Generate audio (text-to-speech)' without mentioning output behavior (e.g., saving a file, returning a task ID), side effects, or any requirements. The description gives no information about what happens after the call.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, front-loaded with the core purpose, and contains no redundant or filler content. Every word contributes to the meaning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

The tool has 8 parameters and no output schema, yet the description provides minimal context. It does not explain what the tool returns, whether it works asynchronously (e.g., requires kie_check_task), or any other operational details needed for correct invocation. The description alone is insufficient for an agent to fully understand the tool's behavior.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, with every parameter documented in the input schema. The description adds no additional parameter meaning beyond the schema, so the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool generates audio via text-to-speech, with a specific verb ('Generate'), resource ('audio'), and method ('text-to-speech'). This distinguishes it from sibling tools like kie_generate_image and kie_generate_video.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies when to use the tool (when audio generation is needed) and the sibling context makes the intended use clear. However, it does not explicitly state when not to use it or mention alternative tools, so it falls short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kie_generate_imageB

Generate an image using AI models via kie.ai

ParametersJSON Schema
NameRequiredDescriptionDefault
seedNoRandom seed for reproducibility
modelNoModel ID (e.g. 'flux-2/pro-text-to-image')
promptYesText prompt describing the image to generate
filenameNoCustom filename (without extension)
output_dirNoOutput directory for the generated file./bilder
aspect_ratioNoAspect ratio (e.g. '1:1', '16:9', '9:16')1:1
guidance_scaleNoGuidance scale for generation
negative_promptNoNegative prompt — what to avoid

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are present, so the description must disclose behavior. It only states a high-level action; it doesn't mention that generation may be asynchronous (suggested by kie_check_task), how the output is returned/saved, or any rate limits or cost implications.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence with no wasted words. However, it sacrifices substance for brevity, not explaining the tool's behavior beyond a basic action.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 8 parameters and no output schema, this description is minimal. It omits the generation workflow (likely returning a task to check via kie_check_task), output file handling (referenced in output_dir), and model selection, leaving the agent under-informed.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already describes all 8 parameters with 100% coverage. The description adds no parameter-specific semantics, leaving the schema to do the heavy lifting, so a baseline score of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Generate') and resource ('an image'), clearly distinguishing this tool from siblings like kie_generate_video and kie_generate_audio. The phrase 'via kie.ai' adds provider context, which is redundant but not harmful.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

No guidance is provided on when to use this tool versus alternatives. It does not mention asynchronous tasks, prerequisites, or when to prefer kie_generate_video or kie_upscale.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kie_generate_videoC

Generate a video using AI models via kie.ai

ParametersJSON Schema
NameRequiredDescriptionDefault
modelNoModel ID for video generation
promptYesText prompt describing the video to generate
durationNoVideo duration in seconds5
filenameNoCustom filename (without extension)
image_urlNoImage URL for image-to-video generation
output_dirNoOutput directory./videos
resolutionNoVideo resolution (e.g. '720p', '1080p')720p
aspect_ratioNoAspect ratio (e.g. '16:9', '9:16')

TDQS

C2.8/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden of behavioral disclosure. It only restates the action without explaining key behaviors such as asynchronous task submission (suggested by kie_check_task), output file handling, or whether the tool blocks waiting for completion. This lack of detail leaves significant uncertainty.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence, which is compact and avoids verbosity. However, it provides minimal information beyond what the tool name already conveys, bordering on under-specification rather than effective conciseness.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with 8 parameters and no output schema, the description is incomplete. It does not explain the workflow, return format, or how parameters like output_dir and filename are used. The existence of kie_check_task strongly implies an async pattern, but the description leaves this unstated.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema provides descriptions for all 8 parameters, offering 100% coverage, so the baseline is 3. The description adds no additional parameter semantics, but the schema already explains each field adequately (e.g., duration, resolution, image_url).

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's function: generating a video via kie.ai. This distinguishes it from sibling tools like kie_generate_image and kie_generate_audio. However, it does not mention the image-to-video capability implied by the image_url parameter, so it falls short of a fully informative purpose statement.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to use this tool versus alternatives. The description does not reference sibling tools or provide criteria for choosing video generation over image or audio generation. Usage context is only implied by the tool name.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kie_list_modelsA

List available AI models from the kie.ai registry

ParametersJSON Schema
NameRequiredDescriptionDefault
typeNoFilter by model type

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description must disclose behavior. It states the tool lists models, implying a read-only operation, but provides no details about output format, pagination, or potential errors. The behavior is simple, so this is adequate but minimal.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single concise sentence with no filler, front-loading the verb and resource. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple list tool with one optional parameter and no output schema, the description plus schema covers the essential information for basic invocation. It could mention return type, but the low complexity makes this relatively complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema fully documents the single optional 'type' parameter with an enum and description. The tool description adds no additional parameter meaning, so the baseline of 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description explicitly states the action ('List') and resource ('available AI models from the kie.ai registry'), clearly distinguishing this tool from sibling generation/checking tools. It is specific and unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies this tool is for discovering available models but doesn't explicitly state when to use it versus alternatives. No direct guidance is given about prerequisites or typical workflows, though the purpose is reasonably clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

kie_upscaleB

Upscale an image using AI models via kie.ai

ParametersJSON Schema
NameRequiredDescriptionDefault
modelNoModel ID for upscalingtopaz/image-upscale
image_urlYesURL of the image to upscale
output_dirNoOutput directory./bilder
upscale_factorNoUpscale factor (e.g. '2', '4')2

TDQS

B3.4/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries full burden. It does not disclose whether the upscaling is synchronous or asynchronous, whether API credentials are needed, what happens to the file, or any error conditions. This makes the tool's behavior opaque beyond the basic operation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single sentence of nine words, which is appropriately sized for a simple operation. It is front-loaded with the verb and resource, containing zero filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With no output schema, no annotations, and four parameters, the description is too sparse. It fails to explain return values, execution semantics (e.g., whether the tool writes to output_dir or returns a URL), or any side effects. This is insufficient for a tool that likely calls an external AI service.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema fully describes all four parameters with defaults and descriptions, so the description adds no additional parameter semantics. Per the rubric, baseline is 3 when schema coverage is high, and this is exactly that case.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Upscale') and resource ('an image') with a clear subject ('AI models via kie.ai'), which distinguishes it from sibling generation tools. It clearly states the core function, earning a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage for image upscaling but provides no explicit guidance on when to use this tool versus alternatives like kie_generate_image, nor any exclusion criteria. It is a bare statement of function, leaving the agent to infer appropriate conditions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 6 tool updatesv1.0.0
    • First observedkie_check_task
    • First observedkie_generate_audio
    • First observedkie_generate_image
    • First observedkie_generate_video
    • First observedkie_list_models
    • First observedkie_upscale

TDQS

A3.6/5.0

Scored across 6 tools

Disambiguation5/5

Each tool targets a distinct operation: generating images, videos, audio, checking task status, upscaling images, and listing models. There is no overlap or ambiguity between these actions.

Naming Consistency4/5

All tool names follow a consistent kie_ prefix with snake_case verbs, but 'kie_upscale' is a verb alone while others use verb_noun (e.g., kie_generate_image). This minor deviation keeps it mostly predictable.

Tool Count5/5

Six tools are well-scoped for an AI media generation server, covering generation across modalities plus task management and model discovery without unnecessary bloat.

Completeness4/5

The surface covers generation, upscaling, task checking, and model listing, which forms a cohesive workflow. Minor gaps like explicit cancelation or result retrieval are indirectly handled via check_task, so the core scope is complete.

Related MCP Connectors

Related MCP Servers