安装
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],适合谁
如果你已经有 Google Maps API 密钥,并希望在 MCP 对话里把一个地址换成坐标,这个服务器对得上。官方说明它是 Google Maps API 的 MCP Server。
它不适合还没有密钥的环境。摘录要求按 Google 文档创建密钥,文档地址是 https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys 。配置变量名是 GOOGLE_MAPS_API_KEY,必须填你自己的密钥,不要复制任何示例占位值。
当前摘录完整写清的工具只有 maps_geocode:输入 address(string),返回 location、formatted_address、place_id。其他能力没有出现在这份摘录里,不要自行补工具名。这是读取地理编码,仍会调用 Google Maps API,不要理解成无网络或无隐私边界。
3 分钟完成第一次尝试
先按上面的文档拿到自己的密钥。官方推荐的主路径是在 MCP 配置里用 npx 启动,不要并列再走 Docker:
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-google-maps"],
在同一配置的环境变量里设置 GOOGLE_MAPS_API_KEY 为你的真实密钥。把这段放进你正在使用的 MCP 客户端配置位置;摘录没有写死文件名。保存并重新加载。
第一次只调用 maps_geocode,输入一个你已经有的地址字符串。不要编造未出现的参数名。成功信号是返回 location、formatted_address 和 place_id,而不是提示缺少 GOOGLE_MAPS_API_KEY,或 npx 无法拉起 @modelcontextprotocol/server-google-maps。
使用案例
案例一:把地址换成坐标。摘录写明 maps_geocode 用于 Convert address to coordinates,输入是 address 字符串,返回值包含 location。你应提交自己的地址。能核到的是 location 字段;坐标格式的更多细节没有写进摘录。
案例二:用同一次地理编码拿到标准地址和地点标识。摘录写明返回还包括 formatted_address 与 place_id。成功时应看到规范化地址和 place_id,而不只是一组坐标。后续还能用这些字段做什么,当前摘录没有给出下一个工具,因此不要把未出现的详情查询写成已证实。
这两个案例都落在 maps_geocode 上,只是分别取 coordinates 与 formatted_address/place_id。当前摘录没有第二套已点名工具。
使用边界
主路径是 npx -y @modelcontextprotocol/server-google-maps,并设置 GOOGLE_MAPS_API_KEY。摘录另外出现了 docker run 镜像 mcp/google-maps,同样需要该环境变量;那是竞争安装路径,第一次不要并列使用。
官方页面是 https://github.com/modelcontextprotocol/servers-archived/tree/main/src/google-maps 。密钥创建说明在 https://developers.google.com/maps/documentation/javascript/get-api-key#create-api-keys 。不要把示例占位密钥写进配置。未出现的工具名、路线规划和配额数字都不要自行补全。