Introduction à Gemini CLI et aux Serveurs MCP

Ce guide explique comment installer l'outil en ligne de commande officiel **Gemini CLI** sur Windows et comment l'étendre avec des **serveurs MCP (Model Context Protocol)** pour interagir avec des services externes comme GitHub, Firecrawl, et les outils de génération multimédia de Google.

Étape 1 : Prérequis Indispensables

• Node.js (v20+): Télécharger
• Git et Git Bash: Télécharger
• Go: Télécharger
• Google Cloud SDK: Installer

Étape 2 : Installation de Gemini CLI

Ouvrez une Invite de commandes (CMD) ou PowerShell et exécutez :

npm install -g @google/gemini-cli

npm install -g @google/gemini-cli@latest

Étape 3 : Authentification

Pour la plupart des MCP avancés, l'authentification via Google Cloud est la plus robuste.

gcloud auth application-default login

Suivez les instructions qui s'ouvrent dans votre navigateur. Cette commande configure une authentification qui sera automatiquement détectée par la CLI et la plupart des outils Google.

Étape 4 : Intégration des Serveurs MCP Avancés

C'est ici que l'on étend les capacités de la CLI. Toutes les configurations se font dans le fichier `settings.json` situé dans `C:\Users\VOTRE_NOM\.gemini\`.

4.1 MCP via NPX (Firecrawl, Context7)

Ces outils s'installent à la volée via `npx`. Ils permettent d'étendre les connaissances de Gemini. Firecrawl permet de lire des pages web et Context7 d'accéder aux modèles les plus récents.

➡️ Obtenir une clé API Firecrawl (requise)

Ajoutez ce bloc à la section `mcpServers` de votre `settings.json` :

"mcp-server-firecrawl": {
  "command": "npx",
  "args": ["-y", "firecrawl-mcp"],
  "env": {
    "FIRECRAWL_API_KEY": "VOTRE_CLÉ_API_FIRECRAWL_ICI"
  }
},
"context7": {
  "command": "npx",
  "args": ["-y", "@upstash/context7-mcp"]
}

4.2 MCP pour GitHub

Pour permettre à Gemini d'interagir avec des dépôts GitHub, vous avez besoin d'un **Personal Access Token (PAT)**.

➡️ Créer un PAT sur GitHub (avec les droits `repo` et `read:user`).

D'abord, définissez le token comme variable d'environnement :

setx GITHUB_GEMINI_CLI_PAT "VOTRE_TOKEN_GITHUB_ICI"

Ensuite, ajoutez ce serveur à `settings.json` :

"github": {
  "httpUrl": "https://api.githubcopilot.com/mcp/",
  "headers": {
    "Authorization": "${GITHUB_GEMINI_CLI_PAT}"
  },
  "timeout": 5000
}

4.3 MCP pour la Génération de Média Google (Imagen, Veo...)

Cette configuration est plus complexe et requiert des informations spécifiques à votre projet Google Cloud.

Une fois que vous avez ces trois informations, définissez-les comme variables d'environnement avec `setx` :

setx GOOGLE_CLOUD_PROJECT "votre-id-de-projet-gcp"
setx GOOGLE_CLOUD_REGION "votre-region-gcp"
setx GOOGLE_STORAGE_BUCKET "le-nom-de-votre-bucket"

Enfin, installez les serveurs avec **Git Bash** :

# 1. Cloner le dépôt
git clone https://github.com/GoogleCloudPlatform/vertex-ai-creative-studio.git

# 2. Naviguer dans le bon dossier
cd vertex-ai-creative-studio/experiments/mcp-genmedia/mcp-genmedia-go

# 3. Lancer le script d'installation
./install.sh

Et ajoutez la configuration correspondante à votre `settings.json` :

"imagen": {
  "command": "mcp-imagen-go",
  "env": {
    "PROJECT_ID": "${GOOGLE_CLOUD_PROJECT}",
    "LOCATION": "${GOOGLE_CLOUD_REGION}",
    "GENMEDIA_BUCKET": "${GOOGLE_STORAGE_BUCKET}"
  }
}

Étape 5 : Vérification et Utilisation

Ouvrez une nouvelle Invite de commandes. Lancez `gemini` et vérifiez les serveurs :

/mcp

Vous devriez voir `github`, `imagen`, `mcp-server-firecrawl`, etc. avec le statut "Ready". Voici quelques exemples :

@imagen Create a photorealistic image of a cat typing on a keyboard
@firecrawl https://www.lemonde.fr "Summarize this article"
@github what are the open issues in the expressjs/express repository?

New Features

Mettre à jour Gemini

npm update -g @google/gemini-cli

Using npx for Always-Latest

npx https://github.com/google-gemini/gemini-cli