Kit d'outils d'assistance au code Google Maps Platform

Description

La boîte à outils Google Maps Platform Code Assist est un serveur MCP (Model Context Protocol) qui améliore les réponses des grands modèles de langage (LLM) utilisés pour développer des applications avec Google Maps Platform en ancrant les réponses dans la documentation et les exemples de code officiels et à jour.

Étant donné que le serveur MCP accède au contenu lorsque le modèle est sollicité, le contexte du LLM concernant Google Maps Platform ne doit pas se limiter aux données disponibles à la date d'entraînement du modèle.

Voici quelques exemples de ressources Google Maps Platform auxquelles le serveur MCP peut accéder :

• Documentation sur Google Maps Platform
• Conditions d'utilisation de Google Maps Platform
• Centre de confiance Google Maps Platform
• Dépôts de code dans les organisations GitHub officielles de Google Maps Platform

Développeurs

• 🪄 Faites de votre assistant IA ou IDE préféré un expert Google Maps Platform. Avec Code Assist, les agents d'IA tels que Gemini CLI, Claude Code et Cursor peuvent générer du code et répondre aux questions des développeurs en s'appuyant sur la documentation et les exemples de code officiels et à jour de Google Maps Platform, directement dans votre workflow de développement.

• 🚀 Que vous apportiez des modifications précises au code à l'aide de l'IA ou que vous créiez un prototype d'application, Code Assist peut vous aider à accomplir votre tâche plus rapidement et plus facilement.

🔧 Outils fournis

Le serveur MCP expose les outils suivants pour les clients d'IA :

1. retrieve-instructions : outil d'assistance utilisé par le client pour obtenir des instructions système essentielles sur la façon de mieux comprendre l'intention de l'utilisateur et de formuler des appels efficaces à l'outil retrieve-google-maps-platform-docs.
2. retrieve-google-maps-platform-docs : outil principal. Il prend une requête en langage naturel et l'envoie à un moteur de génération augmentée par récupération (RAG) hébergé. Le moteur RAG recherche les dernières versions de la documentation, des tutoriels et des exemples de code officiels de Google Maps Platform. Il renvoie ensuite le contexte pertinent à l'IA pour générer une réponse précise.

🛠️ Transports MCP compatibles

Ce serveur est compatible avec deux protocoles de communication MCP standards :

• stdio : il s'agit du transport par défaut utilisé lorsqu'un client appelle le serveur via un command. Il communique via les flux d'entrée/sortie standards, ce qui le rend idéal pour l'exécution locale en ligne de commande.
• Streamable HTTP : le serveur expose un point de terminaison /mcp qui accepte les requêtes POST. Il est utilisé par les clients qui se connectent via un url et constitue la norme pour les connexions à des serveurs distants. Notre implémentation est compatible avec le streaming pour les réponses interactives en temps réel.

🚀 Utilisation

Vous pouvez exécuter le serveur MCP d'assistance au code sur votre machine de développement locale ou à distance sur Google Cloud Run.

Conditions requises

Pour utiliser la boîte à outils Google Maps Platform Code Assist, vous avez besoin d'un environnement avec Node.js (version LTS recommandée) et npm installés pour cloner et exécuter le serveur, ainsi que d'un client MCP pour accéder au serveur.

Utiliser Code Assist comme serveur MCP local avec le transport stdio (recommandé)

Exécutez le serveur sur votre ordinateur local et connectez les clients à l'aide du protocole stdio pour l'utiliser avec des IDE assistés par l'IA (comme VS Code, Android Studio, Cursor) ou des applications d'IA pour ordinateur (comme l'interface de ligne de commande Gemini). Il s'agit de la configuration la plus simple et la plus courante.

Configurer votre client

Ajoutez le serveur au fichier de configuration MCP de votre client d'IA préféré. Recherchez votre client ci-dessous pour obtenir des instructions spécifiques et validées.

1. Gemini Code Assist et CLI Gemini

   • Option 1 : Ajoutez le serveur directement depuis votre ligne de commande (en supposant que vous ayez déjà installé la CLI Gemini) :

      gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
     

     • Vérifiez l'installation en exécutant la commande gemini mcp list.
   • Option 2 : Ajoutez manuellement la configuration du serveur MCP à votre fichier ~/.gemini/settings.json.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

2. Claude Code

   • Option 1 : Ajoutez le serveur directement depuis votre ligne de commande (en supposant que vous ayez déjà installé Claude Code) :

         claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist@latest
     

     • Vérifiez l'installation en exécutant la commande claude mcp list.
     • Utilisateurs Windows : sur Windows natif (et non WSL), vous devez utiliser le wrapper cmd /c pour que les commandes npx fonctionnent correctement.

     claude mcp add google-maps-platform-code-assist -- cmd /c "npx -y @googlemaps/code-assist-mcp@latest"
     

   • Option 2 : Ajouter manuellement le serveur à votre fichier de configuration Claude ~/.claude.json

   "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": [
           "-y", "@googlemaps/code-assist-mc@latest"
         ]
       }
     }
   

3. Cursor

   •  <-- Si vous avez déjà installé Cursor, cliquez ici pour installer directement l'assistance au codage MCP Google Maps Platform.
   • Sinon, ajoutez-la au fichier .cursor-settings/mcp.json de votre espace de travail.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

4. Firebase Studio

   • avec le MCP Code Assist installé
   • Ajoutez-le au fichier mcp.json de votre projet dans le dossier .idx de votre espace de travail Firebase Studio.

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

5. Android Studio

   • Créez un fichier mcp.json et placez-le dans le répertoire de configuration d'Android Studio. Ajoutez le serveur Code Assist à la liste :

   {
     "mcpServers": {
       "google-maps-platform-code-assist": {
         "command": "npx",
         "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
       }
     }
   }
   

6. Cline

   • Option 1 : Installer à l'aide de l'interface utilisateur graphique Cline MCP
   • Option 2 : Installez manuellement / par programmation à l'aide du fichier de configuration Cline MCP. Le fichier de configuration se trouve à l'emplacement suivant :
     • macOS : ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • Windows : %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • Linux : ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
     • Ajoutez les éléments suivants à votre configuration MCP dans cline_mcp_settings.json :

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
           },
           "alwaysAllow": [
             "retrieve-instructions",
             "retrieve-google-maps-platform-docs"
           ]
         }
       }
       

7. Code Roo

   • Option 1 : Installer à l'aide de l'interface utilisateur graphique Roo MCP
   • Option 2 : Installez manuellement / par programmation à l'aide du fichier de configuration Roo Code. Le fichier de configuration se trouve à l'emplacement suivant :
     • macOS : ~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
     • Windows : %APPDATA%\Code\User\globalStorage\rooveterinaryinc.roo-cline\settings\mcp_settings.json
     • Linux : ~/.config/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/mcp_settings.json
     • Ajoutez les éléments suivants à votre configuration MCP dans mcp_settings.json :

       {
         "mcpServers": {
           "google-maps-platform-code-assist": {
             "command": "npx",
             "args": ["-y", "@googlemaps/code-assist-mcp@latest"]
           },
           "alwaysAllow": [
             "retrieve-instructions",
             "retrieve-google-maps-platform-docs"
           ]
         }
       }
       

8. Microsoft Copilot

   • En mode Agent, cliquez sur "Outils", puis dans l'en-tête supérieur, cliquez sur "Configurer les outils", puis sur "Installer à partir d'un nom de package NPM" (voir les captures d'écran ci-dessous).

   • 
   • 
   • 

   • Saisissez le nom du package @googlemaps/code-assist-mcp, puis appuyez sur ENTRÉE pour accepter l'installation et utiliser le port 3000 par défaut. Appuyez une dernière fois sur ENTRÉE pour confirmer la modification.

   • 

9. Planche à voile

   • Identiques aux instructions Cursor ci-dessus.

10. Kilo Code

    • Comme pour les instructions du code Cline et Roo ci-dessus

En savoir plus

Pour en savoir plus sur l'installation et l'utilisation de l'ensemble d'outils, ainsi que sur les conditions d'utilisation, consultez le README du dépôt GitHub.