MCP Image MCP — Anwendungsfälle, Installieren & Live-Demo

Warum nutzen

Hauptfunktionen

Ein Tool: generic_image (deckt Gen + Edit ab)
Automatische Aufforderungserweiterung (Betreff · Kontext · Stil)
Drei Qualitätsstufen: schnell, ausgewogen, Qualität
4K-Auflösung; Seitenverhältnisse 1:1 bis 21:9
Zeichenkonsistenz über Anrufe hinweg
Google-Suche-Erdung + Weltwissen

Live-Demo

In der Praxis

mcp-image.replay ▶ bereit

0/0

Installieren

Wählen Sie Ihren Client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Öffne Claude Desktop → Settings → Developer → Edit Config. Nach dem Speichern neu starten.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Cursor nutzt das gleiche mcpServers-Schema wie Claude Desktop. Projektkonfiguration schlägt die globale.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Klicken Sie auf das MCP-Servers-Symbol in der Cline-Seitenleiste, dann "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-image": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-image"
      ],
      "env": {
        "GEMINI_API_KEY": "<from aistudio.google.com/apikey>",
        "IMAGE_OUTPUT_DIR": "/absolute/path/to/images"
      }
    }
  }
}

Gleiche Struktur wie Claude Desktop. Windsurf neu starten zum Übernehmen.

~/.continue/config.json

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

Continue nutzt ein Array von Serverobjekten statt einer Map.

~/.config/zed/settings.json

{
  "context_servers": {
    "mcp-image": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "mcp-image"
        ]
      }
    }
  }
}

In context_servers hinzufügen. Zed lädt beim Speichern neu.

claude mcp add mcp-image -- npx -y mcp-image

Einzeiler. Prüfen mit claude mcp list. Entfernen mit claude mcp remove.

Anwendungsfälle

Praxisnahe Nutzung: MCP Image

Generieren und iterieren Sie dann ein Heldenbild für eine Zielseite

👤 Designer, Gründer, Vermarkter ⏱ ~15 min beginner

Wann einsetzen: Sie möchten ein frisches Heldenbild und möchten nicht mit 5 Registerkarten jonglieren.

Voraussetzungen

Gemini-API-Schlüssel — https://aistudio.google.com/apikey
Ausgabeverzeichnis — mkdir -p ~/images/mcp

Ablauf

Generieren Sie v1

Erstellen Sie ein Heldenbild: minimaler Arbeitsbereich, warmes Goldstundenlicht, 16:9, Qualitätsstufe, 2048 Pixel.✓ Kopiert

→ Das Bild wurde in IMAGE_OUTPUT_DIR mit angereicherter Rückmeldung gespeichert
An Ort und Stelle bearbeiten

Bearbeiten Sie es – fügen Sie eine dünne Baumreihe am Horizont hinzu, behalten Sie alles andere.✓ Kopiert

→ Variante gespeichert; Zusammensetzung erhalten
Probieren Sie eine Variante aus

Gleiche Szene, aber kühlere Töne. Halten Sie das Motiv identisch.✓ Kopiert

→ Die Charakterkonsistenz bleibt bestehen; Farbe verschoben

Ergebnis: Ein versendbares Heldenbild in wenigen Minuten, kein kostenpflichtiger Hin- und Rückflug durch Midjourney.

Fallstricke

Übermäßige Aufforderung des Optimierers — Lassen Sie den Subject-Context-Style-Enhancer seine Arbeit erledigen; Hören Sie auf, mit 5 Adjektivzeilen zu überschreiben

Kombinieren mit: filesystem

Erstellen Sie eine Reihe markenkonsistenter Illustrationen

👤 Einzelgründer und Designer ohne Marken-Asset-Bibliothek ⏱ ~45 min intermediate

Wann einsetzen: Sie benötigen 6–12 Illustrationen, die zusammenpassen.

Ablauf

Definieren Sie das Stylesheet

Generieren Sie eine Stilreferenz: flache Illustration, weiche Pastellpalette, 2-Zeichen-Vignette.✓ Kopiert

→ Das Seed-Bild fängt den Stil ein
Erstellen Sie Variationen

Erstellen Sie in diesem Stil sechs Illustrationen für unsere Abschnitte: Onboarding, Abrechnung, Team, Integrationen, Sicherheit, Analyse.✓ Kopiert

→ 6 Bilder mit einheitlichem Stil + Charakteren

Ergebnis: Ein zusammenhängendes Illustrationsset, ohne einen Illustrator für einen Tag engagieren zu müssen.

Fallstricke

Driften Sie zwischen den Bildern — Verweisen Sie immer auf das Seed-Bild und verwenden Sie „Stil vom Seed beibehalten“.

Bearbeiten Sie Produktfotos mit natürlicher Sprache

👤 E-Commerce-Betreiber, kleine Marken ⏱ ~20 min beginner

Wann einsetzen: Sie haben ein rohes Produktfoto und möchten die Hero-Behandlung ohne Photoshop.

Ablauf

Laden Sie das Foto hoch bzw. verweisen Sie darauf

Verwenden Sie „product.jpg“ als Basis. Entfernen Sie den überfüllten Hintergrund; Schatten bewahren; Studiobeleuchtung.✓ Kopiert

→ Saubere Produktaufnahme mit natürlichem Schatten
Kontext hinzufügen

Dasselbe Produkt auf einer warmen Marmoroberfläche, von oben nach unten.✓ Kopiert

→ Konsistentes Produkt mit neuer Umgebung

Ergebnis: Katalogfertige Bilder in wenigen Minuten.

Kombinieren mit: filesystem

Kombinationen

Mit anderen MCPs für 10-fache Wirkung

mcp-image + filesystem

Erstellen, listen, taggen und organisieren Sie eine Bildbibliothek

Generieren Sie das heutige Set in ~/images/mcp/2026-04-21/; dann auflisten und nach Alt-Text umbenennen.✓ Kopiert

mcp-image + magic-ui-mcp

Legen Sie generierte Heldenbilder in einer Magic-UI-Landung ab

Generieren Sie ein Heldenbild und verbinden Sie es dann mit der Heldenkomponente der Magic UI.✓ Kopiert

mcp-image + comfyui-mcp-server

Verwenden Sie mcp-image für einmalige Generationen. ComfyUI für Pipelines

Schnelle Varianten über mcp-image; Produktionsworkflow über ComfyUI.✓ Kopiert

Werkzeuge

Was dieses MCP bereitstellt

Werkzeug	Eingaben	Wann aufrufen	Kosten
generate_image	prompt: str, tier?: fast\|balanced\|quality, aspect?: '1:1'\|'16:9'\|..., base_image?: path, size?: '1K'\|'2K'\|'4K'	Erstellen Sie ein neues Bild oder bearbeiten Sie ein vorhandenes mit natürlicher Sprache	1 Gemini image call

Kosten & Limits

Was der Betrieb kostet

API-Kontingent: Gebunden an das Bildgenerierungskontingent Ihres Gemini-API-Plans
Tokens pro Aufruf: Für Text vernachlässigbar; Bildbytes dominieren
Kosten in €: Bezahlen pro Bild über die Gemini-API; Kostenloses Kontingent für die Entwicklung verfügbar
Tipp: Verwenden Sie tier=fast für die Iteration und tier=quality nur für den endgültigen Keeper.

Sicherheit

Rechte, Secrets, Reichweite

Credential-Speicherung: GEMINI_API_KEY nur in env – niemals festschreiben. Bei Durchsickern von Google AI Studio wechseln.

Datenabfluss: Eingabeaufforderungen und optionale Basisbilder gehen an die Gemini-API von Google. Erzeugte Bytes werden zurückgegeben und lokal gespeichert.

Für generierte Bilder gelten die Richtlinien von Google. Generieren Sie keine Inhalte, für deren Weitergabe Sie nicht berechtigt sind.
Basisbilder, die Sie zur Bearbeitung weitergeben, werden auf Gemini hochgeladen – behandeln Sie sie so, als hätten Sie sie im Internet gepostet.

Fehlerbehebung

Häufige Fehler und Lösungen

401 / API-Schlüssel ungültig

Bestätigen Sie, dass GEMINI_API_KEY der rohe API-Schlüssel von AI Studio (kein OAuth-Token) ist und die Bildgenerierung aktiviert ist.

Prüfen: curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY

Ausgaben gespeichert, aber leer

IMAGE_OUTPUT_DIR ist möglicherweise nicht beschreibbar oder fehlt. Erstellen Sie es und versuchen Sie es erneut.

Prüfen: touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe

Charakter driftet zwischen den Generationen

Übergeben Sie immer das gleiche Basisbild und fügen Sie „Betreff identisch halten“ in die Eingabeaufforderung ein.

Prüfen: Diff two generations visually

Alternativen

MCP Image vs. andere

Alternative	Wann stattdessen	Kompromiss
everart	Sie haben stilbewusste Everart-Modelle	Anderer Anbieter, anderer Versicherungsstil
comfyui-mcp-server	Sie benötigen benutzerdefinierte SD/FLUX-Workflows und vollständige Pipeline-Kontrolle	Viel schwereres Setup
higgsfield-ai-prompt-skill	Sie benötigen zeitnahe technische Hilfe für einen anderen Anbieter	Nur Eingabeaufforderungen – keine Rückschlüsse

Mehr

Ressourcen

📖 Offizielle README auf GitHub lesen

🐙 Offene Issues ansehen

🔍 Alle 400+ MCP-Server und Skills durchsuchen