Install
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],Para quem
Se você já tem uma chave da Google Maps API e quer, numa conversa MCP, converter um endereço em coordenadas, este servidor combina. Oficialmente é um MCP Server da API do Google Maps.
Não serve para ambientes que ainda não têm chave. O extrato exige criar uma chave conforme a documentação do Google: https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . O nome da variável de configuração é GOOGLE_MAPS_API_KEY; preencha a sua chave e não copie nenhum valor de exemplo placeholder.
A única ferramenta especificada por completo no extrato atual é maps_geocode: entrada address (string), retorno location, formatted_address, place_id. Outras capacidades não aparecem neste extrato; não invente nomes de ferramentas. Isto é uma leitura de geocodificação e ainda chama a API do Google Maps; não entenda como sem rede nem fronteira de privacidade.
Primeira tentativa em 3 minutos
Primeiro pegue a sua chave na documentação acima. O caminho principal recomendado oficialmente é iniciar com npx na configuração MCP; não tome Docker em paralelo:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],
Nas variáveis de ambiente da mesma configuração, defina GOOGLE_MAPS_API_KEY com a sua chave real. Coloque este bloco no local de configuração do cliente MCP que você já usa; o extrato não trava um nome de arquivo. Salve e recarregue.
Na primeira vez, chame só maps_geocode com uma string de endereço que você já tenha. Não invente nomes de parâmetros que não aparecem. O sinal de sucesso é devolver location, formatted_address e place_id, não um aviso de que falta GOOGLE_MAPS_API_KEY ou de que o npx não sobe @modelcontextprotocol/server-google-maps.
Casos de uso
Caso 1: converter um endereço em coordenadas. O extrato diz que maps_geocode serve para Convert address to coordinates, que a entrada é uma string address e que o retorno inclui location. Você deve enviar o seu próprio endereço. O verificável é o campo location; mais detalhe do formato de coordenadas não entra no extrato.
Caso 2: na mesma geocodificação, obter endereço padronizado e identificador de lugar. O extrato diz que o retorno também inclui formatted_address e place_id. Em caso de sucesso, você deve ver um endereço normalizado e um place_id, não só um conjunto de coordenadas. O que se pode fazer depois com esses campos não é dado como próxima ferramenta no extrato atual; não trate uma consulta de detalhes que não aparece como comprovada.
Os dois casos caem em maps_geocode e só tomam coordinates versus formatted_address/place_id. O extrato atual não tem uma segunda ferramenta nomeada.
Limites de uso
O caminho principal é npx -y @modelcontextprotocol/server-google-maps, mais GOOGLE_MAPS_API_KEY. O extrato também mostra uma imagem docker run mcp/google-maps que igualmente precisa dessa variável; é um caminho de instalação concorrente, não use em paralelo na primeira tentativa.
A página oficial é https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps . As notas de criação de chave estão em https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys . Não escreva uma chave de exemplo placeholder na configuração. Não complete por conta própria nomes de ferramentas, planejamento de rotas nem números de cota que não aparecem.