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

Description

Le kit d'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 les basant sur 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 invité, le contexte du LLM concernant Google Maps Platform n'a pas besoin d'être limité aux données disponibles à la date d'entraînement du modèle.

Les ressources Google Maps Platform auxquelles le serveur MCP peut accéder incluent les suivantes :

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

Outils fournis

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

retrieve-instructions: outil d'assistance utilisé par le client pour obtenir des instructions système essentielles sur la meilleure façon de raisonner sur l'intention de l'utilisateur et de formuler des appels efficaces à l'outil retrieve-google-maps-platform-docs.
retrieve-google-maps-platform-docs: outil principal. Il prend une requête en langage naturel et l'envoie à un moteur RAG (Retrieval Augmented Generation) hébergé. Le moteur RAG recherche les versions les plus récentes de la documentation, des tutoriels et des exemples de code officiels de Google Maps Platform, et renvoie un 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 une 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 une url et constitue la norme pour les connexions de serveur à distance. 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 Code Assist sur votre machine de développement locale ou à distance sur Google Cloud Run.

Conditions requises

Pour utiliser le kit d'outils Google Maps Platform Code Assist, vous avez besoin d'un environnement dans lequel Node.js (version LTS recommandée) et npm sont installés afin de cloner et d'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 machine locale et connectez les clients à l'aide du protocole stdio pour une utilisation avec des IDE assistés par IA (tels que VS Code, Android Studio, Cursor) ou des applications d'IA de bureau (telles que Gemini CLI). 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 vérifiées.

Gemini Code Assist & Gemini CLI
- Option 1 : Ajoutez le serveur directement depuis votre ligne de commande (en supposant que Gemini CLI est déjà installé) :
```
 gemini mcp add google-maps-platform-code-assist npx -y @googlemaps/code-assist-mcp@latest
```
  - Vérifiez l'installation en exécutant gemini mcp list.
- Option 2 : Installez le serveur MCP Code Assist en tant qu'extension Gemini CLI :
```
gemini extensions install https://github.com/googlemaps/platform-ai.git
```
- Option 3 : 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"]
    }
  }
}
```
Claude Code
- Option 1 : Ajoutez le serveur directement depuis votre ligne de commande (en supposant que Claude Code est déjà installé) :
```
    claude mcp add google-maps-platform-code-assist -- npx -y @googlemaps/code-assist-mcp@latest
```
  - Vérifiez l'installation en exécutant claude mcp list.
  - Utilisateurs Windows : sous 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 : Ajoutez manuellement le serveur à votre fichier de configuration Claude ~/.claude.json.
```
"mcpServers": {
    "google-maps-platform-code-assist": {
      "command": "npx",
      "args": [
        "-y", "@googlemaps/code-assist-mcp@latest"
      ]
    }
  }
```
Cursor
- <-- Si Cursor est déjà installé, cliquez ici pour installer directement Google Maps Platform Code Assist MCP.
- Sinon, ajoutez-le 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"]
    }
  }
}
```

Firebase Studio

avec Code Assist MCP 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"]
    }
  }
}

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"]
    }
  }
}

Cline
- Option 1 : Installez-le à l'aide de l'interface graphique Cline MCP.
- Option 2 : Installez-le manuellement ou 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"
      ]
    }
  }
}
```
Roo Code
- Option 1 : Installez-le à l'aide de l'interface graphique Roo MCP.
- Option 2 : Installez-le manuellement ou 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"
      ]            
    }
  }
}
```
Microsoft Copilot
- En mode Agent, cliquez sur "Outils", puis dans l'en-tête supérieur, 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. Acceptez l'installation et utilisez le port par défaut 3000, puis appuyez une dernière fois sur Entrée pour confirmer la modification.
Windsurf
- Semblable aux instructions Cursor ci-dessus.
Kilo Code
- Semblable aux instructions Cline et Roo Code ci-dessus.

En savoir plus

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

Kit d'outils d'assistance au code Google Maps Platform Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.