MCP

先用 maps_geocode 把地址换成坐标

适合要把地址解析成坐标、标准地址或 place_id 的人,但必须先自备 Google Maps API 密钥并用 npx 拉起服务;当前摘录只把 maps_geocode 的输入输出写全,其他工具名不要补。

官方来源 · server-google-maps

安装

"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 。不要把示例占位密钥写进配置。未出现的工具名、路线规划和配额数字都不要自行补全。