Install
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],Para quién
Si ya tienes una clave de Google Maps API y quieres, en una conversación MCP, convertir una dirección en coordenadas, este servidor encaja. Oficialmente es un MCP Server de la API de Google Maps.
No encaja en entornos que aún no tienen clave. El extracto exige crear una clave según la documentación de Google: https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . El nombre de variable de configuración es GOOGLE_MAPS_API_KEY; rellena tu propia clave y no copies ningún valor de ejemplo de relleno.
La única herramienta especificada por completo en el extracto actual es maps_geocode: entrada address (string), devuelve location, formatted_address, place_id. Otras capacidades no aparecen en este extracto; no inventes nombres de herramientas. Es una lectura de geocodificación y sigue llamando a la API de Google Maps; no lo entiendas como sin red ni frontera de privacidad.
Primer intento en 3 minutos
Primero obtén tu clave con la documentación de arriba. La vía principal recomendada oficialmente es arrancar con npx en la configuración MCP; no tomes Docker en paralelo:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],
En las variables de entorno de la misma configuración, pon GOOGLE_MAPS_API_KEY con tu clave real. Coloca este bloque en la ubicación de configuración del cliente MCP que ya usas; el extracto no fija un nombre de archivo. Guarda y recarga.
La primera vez, llama solo a maps_geocode con una cadena de dirección que ya tengas. No inventes nombres de parámetros que no aparecen. La señal de éxito es devolver location, formatted_address y place_id, no un aviso de que falta GOOGLE_MAPS_API_KEY o de que npx no puede levantar @modelcontextprotocol/server-google-maps.
Casos de uso
Caso 1: convertir una dirección en coordenadas. El extracto dice que maps_geocode sirve para Convert address to coordinates, que la entrada es una cadena address y que el retorno incluye location. Debes enviar tu propia dirección. Lo verificable es el campo location; más detalle del formato de coordenadas no está en el extracto.
Caso 2: con la misma geocodificación, obtener dirección normalizada e identificador de lugar. El extracto dice que el retorno también incluye formatted_address y place_id. Si tiene éxito, deberías ver una dirección normalizada y un place_id, no solo un conjunto de coordenadas. Qué se puede hacer después con esos campos no se da como siguiente herramienta en el extracto actual; no presentes una consulta de detalles que no aparece como demostrada.
Ambos casos recaen en maps_geocode y solo toman coordinates frente a formatted_address/place_id. El extracto actual no tiene una segunda herramienta nombrada.
Límites de uso
La vía principal es npx -y @modelcontextprotocol/server-google-maps, más GOOGLE_MAPS_API_KEY. El extracto también muestra una imagen docker run mcp/google-maps que igualmente necesita esa variable; es una vía de instalación competidora, no la uses en paralelo en el primer intento.
La página oficial es https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps . Las notas de creación de clave están en https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . No escribas una clave de ejemplo de relleno en la configuración. No completes por tu cuenta nombres de herramientas, planificación de rutas ni cifras de cuota que no aparecen.