Install
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],Pour qui
Si vous avez déjà une clé Google Maps API et voulez, dans une conversation MCP, convertir une adresse en coordonnées, ce serveur convient. Officiellement, c’est un MCP Server pour l’API Google Maps.
Il ne convient pas aux environnements encore sans clé. L’extrait exige de créer une clé selon la documentation Google : https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . Le nom de variable de configuration est GOOGLE_MAPS_API_KEY ; saisissez votre propre clé, sans copier une valeur d’exemple factice.
Le seul outil entièrement spécifié dans l’extrait actuel est maps_geocode : entrée address (string), retour location, formatted_address, place_id. Les autres capacités n’apparaissent pas dans cet extrait ; n’inventez pas de noms d’outils. C’est une lecture de géocodage qui appelle encore l’API Google Maps ; ne le comprenez pas comme sans réseau ni frontière de confidentialité.
Premier essai en 3 minutes
Obtenez d’abord votre clé via la documentation ci-dessus. Le chemin principal recommandé officiellement est de démarrer avec npx dans la configuration MCP, sans prendre Docker en parallèle :
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],
Dans les variables d’environnement de la même configuration, définissez GOOGLE_MAPS_API_KEY avec votre vraie clé. Placez ce bloc à l’emplacement de configuration du client MCP que vous utilisez déjà ; l’extrait ne fige pas de nom de fichier. Enregistrez et rechargez.
La première fois, n’appelez que maps_geocode avec une chaîne d’adresse que vous avez déjà. N’inventez pas de noms de paramètres jamais apparus. Le signal de succès est le retour de location, formatted_address et place_id, pas un message d’absence de GOOGLE_MAPS_API_KEY ou l’échec de npx à lancer @modelcontextprotocol/server-google-maps.
Cas d’usage
Cas 1 : convertir une adresse en coordonnées. L’extrait dit que maps_geocode sert à Convert address to coordinates, que l’entrée est une chaîne address, et que le retour contient location. Soumettez votre propre adresse. Ce qui se vérifie est le champ location ; le détail supplémentaire du format de coordonnées n’est pas dans l’extrait.
Cas 2 : obtenir, du même géocodage, une adresse normalisée et un identifiant de lieu. L’extrait dit que le retour inclut aussi formatted_address et place_id. En cas de succès, vous devez voir une adresse normalisée et un place_id, pas seulement un jeu de coordonnées. Ce qu’on peut faire ensuite avec ces champs n’est pas donné comme outil suivant dans l’extrait actuel ; ne présentez pas une requête de détails jamais apparue comme prouvée.
Les deux cas reposent sur maps_geocode et ne prennent que coordinates versus formatted_address/place_id. L’extrait actuel n’a pas de second outil nommé.
Limites d’usage
Le chemin principal est npx -y @modelcontextprotocol/server-google-maps, plus GOOGLE_MAPS_API_KEY. L’extrait montre aussi une image docker run mcp/google-maps, qui a besoin de la même variable ; c’est un chemin d’installation concurrent, à ne pas utiliser en parallèle au premier essai.
La page officielle est https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps . Les notes de création de clé sont à https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . N’écrivez pas une clé d’exemple factice dans la configuration. N’inventez pas les noms d’outils, la planification d’itinéraire ou les chiffres de quota absents.