KieAI MCP

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

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
• PORT — 3001 (oder nach Bedarf)

1. Domain zuweisen — Über die Coolify-Oberfläche eine Domain konfigurieren (z.B. kie-mcp.deine-domain.de)
2. 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