MCP Image MCP — Cas d'usage, Installer & Démo en direct

Pourquoi l'utiliser

Fonctionnalités clés

Un outil : generate_image (couvre la génération + l'édition)
Amélioration automatique des invites (Sujet · Contexte · Style)
Trois niveaux de qualité : rapide, équilibré, qualité
Résolution 4K ; formats d'image 1:1 à 21:9
Cohérence des caractères entre les appels
Base de recherche Google + connaissance du monde

Démo en direct

Aperçu en pratique

mcp-image.replay ▶ prêt

0/0

Installer

Choisissez votre 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"
      }
    }
  }
}

Ouvrez Claude Desktop → Settings → Developer → Edit Config. Redémarrez après avoir enregistré.

~/.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 utilise le même schéma mcpServers que Claude Desktop. La config projet l'emporte sur la 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"
      }
    }
  }
}

Cliquez sur l'icône MCP Servers dans la barre latérale Cline, puis "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"
      }
    }
  }
}

Même format que Claude Desktop. Redémarrez Windsurf pour appliquer.

~/.continue/config.json

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

Continue utilise un tableau d'objets serveur plutôt qu'une map.

~/.config/zed/settings.json

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

Ajoutez dans context_servers. Zed recharge à chaud à la sauvegarde.

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

Une seule ligne. Vérifiez avec claude mcp list. Supprimez avec claude mcp remove.

Cas d'usage

Usages concrets : MCP Image

Générez puis itérez une image de héros pour une page de destination

👤 Designers, fondateurs, marketeurs ⏱ ~15 min beginner

Quand l'utiliser : Vous voulez une nouvelle image de héros et vous ne voulez pas jongler avec 5 onglets.

Prérequis

Clé API Gémeaux — https://aistudio.google.com/apikey
Répertoire de sortie — mkdir -p ~/images/mcp

Déroulement

Générer la v1

Générez une image de héros : espace de travail minimal, lumière chaude de l'heure dorée, 16:9, niveau de qualité, 2 048 px.✓ Copié

→ Image enregistrée dans IMAGE_OUTPUT_DIR avec une invite enrichie renvoyée
Modifier sur place

Modifiez-le : ajoutez une fine ligne d'arbres à l'horizon, conservez tout le reste.✓ Copié

→ Variante enregistrée ; composition conservée
Essayez une variante

Même scène mais tons plus froids, gardez le sujet identique.✓ Copié

→ La cohérence du caractère est valable ; couleur décalée

Résultat : Une image de héros livrable en quelques minutes, pas un aller-retour payant via Midjourney.

Pièges

Invite excessive de l'optimiseur — Laissez l'amplificateur Sujet-Contexte-Style faire son travail ; arrêtez de passer outre avec 5 lignes d'adjectifs

Combiner avec : filesystem

Produire un ensemble d’illustrations cohérentes avec la marque

👤 Fondateurs et designers solos sans bibliothèque d'actifs de marque ⏱ ~45 min intermediate

Quand l'utiliser : Vous avez besoin de 6 à 12 illustrations qui semblent aller ensemble.

Déroulement

Définir la feuille de style

Générez une référence de style : illustration plate, palette pastel tendre, vignette à 2 caractères.✓ Copié

→ L'image de départ capture le style
Créer des variantes

En utilisant ce style, réalisez 6 illustrations pour nos sections : intégration, facturation, équipe, intégrations, sécurité, analyses.✓ Copié

→ 6 images avec un style cohérent + personnages

Résultat : Un ensemble d’illustrations cohérent sans embaucher un illustrateur pendant une journée.

Pièges

Dérive entre les images — Faites toujours référence à l'image de départ et utilisez « conserver le style de la graine »

Modifiez les photos de produits en langage naturel

👤 Opérateurs de commerce électronique, petites marques ⏱ ~20 min beginner

Quand l'utiliser : Vous avez une photo de produit brut et souhaitez le traitement héros sans Photoshop.

Déroulement

Télécharger/référencer la photo

Utilisez product.jpg comme base. Supprimez l'arrière-plan encombré ; garder l'ombre; éclairage des studios.✓ Copié

→ Photo de produit propre avec une ombre naturelle
Ajouter du contexte

Même produit sur une surface de marbre chaude, de haut en bas.✓ Copié

→ Produit cohérent avec un nouvel environnement

Résultat : Images prêtes à être cataloguées en quelques minutes.

Combiner avec : filesystem

Combinaisons

Associez-le à d'autres MCPs pour un effet X10

mcp-image + filesystem

Générer, répertorier, étiqueter et organiser une bibliothèque d'images

Générez l'ensemble d'aujourd'hui dans ~/images/mcp/2026-04-21/ ; puis répertoriez et renommez par texte alternatif.✓ Copié

mcp-image + magic-ui-mcp

Déposez les images de héros générées dans un atterrissage Magic UI

Générez une image de héros, puis connectez-la au composant héros de Magic UI.✓ Copié

mcp-image + comfyui-mcp-server

Utilisez mcp-image pour des générations uniques ; ComfyUI pour les pipelines

Variantes rapides via mcp-image ; flux de production via ComfyUI.✓ Copié

Outils

Ce que ce MCP expose

Outil	Entrées	Quand appeler	Coût
generate_image	prompt: str, tier?: fast\|balanced\|quality, aspect?: '1:1'\|'16:9'\|..., base_image?: path, size?: '1K'\|'2K'\|'4K'	Générez une nouvelle image ou modifiez une image existante avec le langage naturel	1 Gemini image call

Coût et limites

Coût d'exécution

Quota d'API: Lié par le quota de génération d'images de votre plan API Gemini
Tokens par appel: Négligeable pour le texte ; les octets d'image dominent
Monétaire: Paiement par image via l'API Gemini ; niveau gratuit disponible pour le développement
Astuce: Utilisez tier=fast pour l'itération et tier=quality uniquement pour le gardien final.

Sécurité

Permissions, secrets, portée

Stockage des identifiants : GEMINI_API_KEY en environnement uniquement – ne jamais valider. Faites pivoter depuis Google AI Studio en cas de fuite.

Sortie de données : Les invites et les images de base facultatives sont transmises à l'API Gemini de Google. Les octets générés reviennent et sont enregistrés localement.

Les politiques de Google s'appliquent aux images générées. Ne générez pas de contenu que vous n'avez pas le droit de partager.
Les images de base que vous transmettez pour les modifications sont téléchargées sur Gemini : traitez-les comme si vous les aviez publiées sur Internet.

Dépannage

Erreurs courantes et correctifs

401 / Clé API invalide

Confirmez que GEMINI_API_KEY est la clé API brute d'AI Studio (et non le jeton OAuth) et que la génération d'images est activée.

Vérifier : curl https://generativelanguage.googleapis.com/v1beta/models?key=$GEMINI_API_KEY

Sorties enregistrées mais vides

IMAGE_OUTPUT_DIR est peut-être non accessible en écriture ou manquant. Créez-le et réessayez.

Vérifier : touch $IMAGE_OUTPUT_DIR/.probe && rm $IMAGE_OUTPUT_DIR/.probe

Le caractère dérive entre les générations

Transmettez toujours la même base_image et incluez « garder le sujet identique » dans l'invite.

Vérifier : Diff two generations visually

Alternatives

MCP Image vs autres

Alternative	Quand l'utiliser	Compromis
everart	Vous avez des modèles Everart formés au style	Fournisseur différent, couverture de style différent
comfyui-mcp-server	Vous avez besoin de flux de travail SD/FLUX personnalisés et d'un contrôle total du pipeline	Configuration beaucoup plus lourde
higgsfield-ai-prompt-skill	Vous souhaitez une aide technique rapide pour un autre fournisseur	Invites uniquement – aucune inférence

Plus

Ressources

📖 Lire le README officiel sur GitHub

🐙 Voir les issues ouvertes

🔍 Parcourir les 400+ serveurs MCP et Skills