Gemini Studio MCP

Un serveur MCP qui donne à ton assistant IA (Claude Code, Cursor, VS Code…) la capacité de créer des images et des vidéos avec les modèles de Google AI Studio — et surtout d'itérer dessus : regarder le résultat, demander une correction, recommencer.

MCP (Model Context Protocol) est le standard qui permet à un assistant IA d'appeler des « outils » externes. Ce serveur expose 6 outils ; ton assistant décide seul quand les utiliser.

Exemples de demandes une fois branché :

• « Génère une affiche 4:5 pour un concert de makossa à Douala, style rétro années 80. »

• « Retouche /home/moi/photo.png : remplace le fond par une plage au coucher du soleil. »

• « Fais une vidéo verticale de 8 s d'un taxi jaune qui traverse Yaoundé sous la pluie, vérifie le rendu et corrige ce qui ne colle pas. »

Prérequis

• Node.js 22 ou 24 (20 minimum) — vérifie avec node -v.

• Une clé API Google AI Studio — à créer gratuitement sur https://aistudio.google.com/apikey. ⚠️ La génération d'images et de vidéos n'est pas incluse dans le niveau gratuit (Google y fixe un quota à 0) : il faut activer la facturation sur le projet Google lié à la clé. Avec une clé gratuite, seuls gemini_analyser_media et gemini_lister_modeles fonctionnent. ℹ️ Les abonnements grand public (Google AI Plus, offres étudiantes) donnent accès à Flow et à l'app Gemini, pas à l'API. Seuls Google AI Pro et Ultra incluent des crédits Google Cloud (10 $ et 100 $ par mois) utilisables avec ce serveur, à activer sur le Google Developer Program.

• Un client MCP : Claude Code, Cursor, VS Code (Copilot), Claude Desktop…

Related MCP server: nano-banana-mcpv2

Installation

# 1. Forke le dépôt sur GitHub, puis clone TON fork
git clone https://github.com/<ton-pseudo>/MCP_ServerGoogleAiStudio.git
cd MCP_ServerGoogleAiStudio

# 2. Installe les dépendances
npm install

# 3. Crée ton fichier .env à partir du modèle
cp .env.example .env          # Windows (cmd) : copy .env.example .env

Ouvre .env et colle ta clé après GEMINI_API_KEY=. Ce fichier ne doit jamais être commité (il est déjà dans .gitignore).

# 4. Démarre le serveur
npm run dev

Tu dois voir Serveur MCP Gemini prêt sur http://127.0.0.1:3000/mcp. npm run dev redémarre tout seul quand tu modifies le code ou le .env ; npm start le lance sans surveillance.

Vérification rapide : ouvre http://127.0.0.1:3000/api dans ton navigateur → {"statut":"ok", …}.

Brancher ton client

Le serveur doit tourner (npm run dev) pendant que tu utilises ton assistant.

Claude Code

claude mcp add --transport http --scope user gemini-studio http://127.0.0.1:3000/mcp

Cursor

Fichier ~/.cursor/mcp.json :

{ "mcpServers": { "gemini-studio": { "url": "http://127.0.0.1:3000/mcp" } } }

VS Code (Copilot, mode agent)

Fichier .vscode/mcp.json de ton projet :

{ "servers": { "gemini-studio": { "type": "http", "url": "http://127.0.0.1:3000/mcp" } } }

Claude Desktop

Il ne parle qu'aux serveurs locaux en stdio ; on passe par le pont mcp-remote dans claude_desktop_config.json :

{ "mcpServers": { "gemini-studio": { "command": "npx", "args": ["-y", "mcp-remote", "http://127.0.0.1:3000/mcp"] } } }

Tester sans assistant

npm run inspecteur, choisis le transport « Streamable HTTP » et l'URL http://127.0.0.1:3000/mcp, puis appelle les outils à la main.

Les outils

Les fichiers sont enregistrés dans generations/images/ et generations/videos/.

Comment l'itération fonctionne

Chaque génération renvoie un interaction_id. L'assistant le repasse dans interaction_precedente avec un prompt qui décrit seulement la correction (« passe la scène de nuit ») : Google garde le contexte, inutile de renvoyer l'image.

Une vidéo prend de 11 s à 6 min. Pour ne pas bloquer l'assistant, le lancement rend tout de suite un identifiant de tâche ; gemini_suivre_video attend jusqu'à 30 s par appel, puis l'assistant rappelle.

Coûts

Chaque appel de génération est facturé sur ta clé. Tarifs indicatifs (octobre 2026, voir https://ai.google.dev/gemini-api/docs/pricing) :

Bonnes pratiques :

• fais tes essais en petit (taille: "512", resolution: "360p" pour Omni, modèles lite ou fast) ;

• surveille ta consommation sur https://aistudio.google.com ;

• gemini_lister_modeles et gemini_suivre_video sont gratuits.

Dépannage

Les modèles Veo et Omni sont récents chez Google : leurs paramètres peuvent évoluer. Si un appel échoue, ouvre une issue avec le message d'erreur.

Organisation du code

server.js                     démarre Express
src/config.js                 lit le .env, liste des modèles
src/app.js                    Express + protections localhost, routes /api et /mcp
src/route/  src/controller/   /api (état du serveur) et /mcp (protocole MCP)
src/mcp/serveur.js            crée le serveur MCP et enregistre les outils
src/mcp/tool/*.tool.js        un fichier par famille d'outils
src/service/                  client Gemini, fichiers, tâches vidéo en arrière-plan

Construit avec le SDK MCP TypeScript v2, @google/genai, Express 5 et zod.

Ajouter ton propre outil

1. Crée src/mcp/tool/mon-outil.tool.js en t'inspirant de modele.tool.js (le plus court) : un schéma zod pour les paramètres, une description claire, une fonction qui renvoie reponseTexte(...) ou reponseErreur(...).

2. Enregistre-le dans src/mcp/serveur.js.

3. Redémarre ton client MCP pour qu'il recharge la liste des outils.

La description de l'outil est lue par l'IA : c'est elle qui décide quand l'appeler. Écris-la comme une consigne à un collègue.

Sécurité

• Le serveur écoute uniquement sur 127.0.0.1 et refuse les requêtes venant d'un site web (vérification des en-têtes Host et Origin). Il n'a pas d'authentification : ne l'expose pas sur 0.0.0.0 ni sur Internet.

• Ne commite jamais ton .env. Si ta clé fuit, supprime-la sur AI Studio et crée-en une autre.

Limites

• Les tâches vidéo vivent en mémoire : un redémarrage du serveur les oublie (les fichiers déjà enregistrés restent, et les interaction_id d'Omni et des images restent valides).

• Une vidéo Veo ne peut être prolongée que pendant 2 jours (durée de conservation chez Google).

• Médias d'entrée : chemins absolus, 20 Mo maximum.

Licence

ISC — libre de l'utiliser, le modifier et le redistribuer.