MCP Reference: mapstools.googleapis.com

Model Context Protocol (MCP) 服务器充当外部服务（为大语言模型 [LLM] 或 AI 应用提供上下文、数据或功能）与 LLM 或 AI 应用之间的代理。MCP 服务器将 AI 应用连接到数据库和 Web 服务等外部系统，并将这些系统的响应转换为 AI 应用可理解的格式。

服务器设置

您必须先启用 MCP 服务器并设置身份验证，然后才能使用。如需详细了解如何使用 Google 和 Google Cloud 远程 MCP 服务器，请参阅 Google Cloud MCP servers overview。

这是一个由 Maps Grounding Lite API 提供的 MCP 服务器。该服务器为开发者提供了在 Google Maps Platform 上构建 LLM 应用的工具。

服务器端点

MCP 服务端点是 MCP 服务器的网络地址和通信接口（通常是网址），AI 应用（MCP 客户端的宿主）使用该端点来建立安全、标准化的连接。它是 LLM 请求上下文、调用工具或访问资源的交互点。Google MCP 端点可以是全球性的，也可以是区域性的。

mapstools.googleapis.com MCP 服务器具有以下 MCP 端点：

https://mapstools.googleapis.com/mcp

MCP 工具

MCP 工具是 MCP 服务器向 LLM 或 AI 应用公开的函数或可执行功能，用于在现实世界中执行操作。

mapstools.googleapis.com MCP 服务器具有以下工具：

MCP 工具

MCP 工具
search_places	当用户的请求是查找地点、商家、地址、位置、地图注点或任何其他与 Google 地图相关的搜索时，请调用此工具。输入要求（重要）： `text_query`（字符串 - 必需）：主要搜索查询。此查询必须清楚地定义用户要查找的内容。示例： `'restaurants in New York'`、`'coffee shops near Golden Gate Park'`、`'SF MoMA'`、`'1600 Amphitheatre Pkwy, Mountain View, CA, USA'`、`'pets friendly parks in Manhattan, New York'`、`'date night restaurants in Chicago'`、`'accessible public libraries in Los Angeles'`。如需了解特定地点的详细信息：请添加请求的属性（例如 `'Google Store Mountain View opening hours'`、`'SF MoMa phone number'`、`'Shoreline Park Mountain View address'`）。 `location_bias`（对象 - 可选）：使用此参数可优先显示特定地理区域附近的结果。格式： `{"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}` 用法：偏向于 5 公里半径范围内的结果： `{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}` 强烈偏向于中心点： `{"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}`（省略 `radius_meters`）。 `language_code`（字符串 - 可选）：用于显示搜索结果摘要的语言。格式：由两个字母组成的语言代码 (ISO 639-1)，可以选择后跟下划线和由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 `en`、`ja`、`en_US`、`zh_CN`、`es_MX`。如果未提供语言代码，结果将以英语显示。 `region_code`（字符串 - 可选）：用户的 Unicode CLDR 区域代码。此参数用于显示地点详细信息，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。格式：由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 `US`、`CA`。工具调用说明：位置信息（重要）：搜索必须包含足够的位置信息。如果位置不明确（例如仅“披萨店”），您必须在 `text_query` 中指定位置（例如“纽约的披萨店”），或者使用 `location_bias` 参数。如果需要消除歧义，请添加城市、州/省/自治区/直辖市和区域/国家/地区名称。请始终提供尽可能具体且贴合上下文的 `text_query`。只有在明确提供坐标的情况下，或者在从用户的已知上下文中推断位置信息是合适且必要的情况下，才使用 `location_bias`，以获得更好的结果。
lookup_weather	检索全面的天气数据，包括当前天气状况、每小时天气预报和每日天气预报。可用的具体数据：温度（当前温度、体感温度、最高/最低温度、热指数）、风（风速、阵风、风向）、天象（日出/日落、月相）、降水（类型、概率、降水量/QPF）、大气状况（紫外线指数、湿度、云量、雷暴概率）和地理编码位置地址。位置和位置规则（重要）：使用“location”字段指定请求天气数据的位置。此字段是一个“oneof”结构，这意味着您必须为以下三个位置子字段中的一个提供值，以确保准确查找天气数据。地理坐标 (lat_lng) 当您获得确切的纬度/经度坐标时，请使用此字段。示例："lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // 洛杉矶地点 ID (place_id) 一个明确的字符串标识符（Google 地图地点 ID）。您可以从 search_places 工具中获取 place_id。示例："place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // 埃菲尔铁塔地址字符串 (address) 一个自由格式的字符串，需要具体说明才能进行地理编码。城市和区域：请始终添加区域/国家/地区（例如“London, UK”，而不是“London”）。街道地址：请提供完整地址（例如“1600 Pennsylvania Ave NW, Washington, DC”）。邮政编码：必须附带国家/地区名称（例如“90210, USA”，而不是“90210”）。使用模式： 1. 当前天气：仅提供 `address`。请勿指定 `date` 和 `hour`。每小时天气预报：提供 `address`、`date` 和 `hour` (0-23)。适用于特定时间（例如“下午 5 点”）或“未来几个小时”或“今天晚些时候”等术语。如果用户指定了分钟，请向下舍入到最接近的小时。不支持从现在起 48 小时后的每小时天气预报。每日天气预报：提供 `address` 和 `date`。请勿指定 `hour`。适用于一般日期请求（例如“明天的天气”“周五的天气”“12/25 的天气”）。如果上下文中没有今天的日期，您应向用户说明。不支持包括今天在内的 7 天后的每日天气预报。不支持历史天气。参数限制： * 时区：所有 `date` 和 `hour` 输入都必须相对于位置的当地时区，而不是用户的时区。日期格式：输入必须分为 `{year, month, day}` 整数。单位：默认为 `METRIC`。如果用户暗示使用美国标准或明确要求使用美国标准，请将 `units_system` 设置为 `IMPERIAL` 以使用华氏度/英里。
compute_routes	计算指定出发地和目的地之间的行程路线。支持的出行方式： DRIVE（默认）、WALK。输入要求（重要）：需要出发地和目的地。必须使用以下方法之一在各自的字段中嵌套提供每个字段： address：（字符串，例如“Eiffel Tower, Paris”）。注意：输入地址越精细或具体，结果就越好。 lat_lng:：（对象，{"latitude": number, "longitude": number}） place_id:：（字符串，例如“ChIJOwE_Id1w5EAR4Q27FkL6T_0”）注意：此 ID 可从 search_places 工具中获取。允许使用任何输入类型组合（例如，按地址作为出发地，按 lat_lng 作为目的地）。如果缺少出发地或目的地，您必须先询问用户以进行澄清，然后再尝试调用该工具。工具调用示例： {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

search_places

当用户的请求是查找地点、商家、地址、位置、地图注点或任何其他与 Google 地图相关的搜索时，请调用此工具。

输入要求（重要）：

text_query（字符串 - 必需）：主要搜索查询。此查询必须清楚地定义用户要查找的内容。
- 示例： 'restaurants in New York'、'coffee shops near Golden Gate Park'、'SF MoMA'、'1600 Amphitheatre Pkwy, Mountain View, CA, USA'、'pets friendly parks in Manhattan, New York'、'date night restaurants in Chicago'、'accessible public libraries in Los Angeles'。
- 如需了解特定地点的详细信息：请添加请求的属性（例如 'Google Store Mountain View opening hours'、'SF MoMa phone number'、'Shoreline Park Mountain View address'）。
location_bias（对象 - 可选）：使用此参数可优先显示特定地理区域附近的结果。
- 格式： {"location_bias": {"circle": {"center": {"latitude": [value], "longitude": [value]}, "radius_meters": [value (optional)]}}}
- 用法：
  - 偏向于 5 公里半径范围内的结果： {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}, "radius_meters": 5000}}}
  - 强烈偏向于中心点： {"location_bias": {"circle": {"center": {"latitude": 34.052235, "longitude": -118.243683}}}}（省略 radius_meters）。
language_code（字符串 - 可选）：用于显示搜索结果摘要的语言。
- 格式：由两个字母组成的语言代码 (ISO 639-1)，可以选择后跟下划线和由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 en、ja、en_US、zh_CN、es_MX。如果未提供语言代码，结果将以英语显示。
region_code（字符串 - 可选）：用户的 Unicode CLDR 区域代码。此参数用于显示地点详细信息，例如特定于区域的地点名称（如果有）。此参数可能会根据适用法律影响结果。
- 格式：由两个字母组成的国家/地区代码 (ISO 3166-1 alpha-2)，例如 US、CA。

工具调用说明：

位置信息（重要）：搜索必须包含足够的位置信息。如果位置不明确（例如仅“披萨店”），您必须在 text_query 中指定位置（例如“纽约的披萨店”），或者使用 location_bias 参数。如果需要消除歧义，请添加城市、州/省/自治区/直辖市和区域/国家/地区名称。
请始终提供尽可能具体且贴合上下文的 text_query。
只有在明确提供坐标的情况下，或者在从用户的已知上下文中推断位置信息是合适且必要的情况下，才使用 location_bias，以获得更好的结果。

lookup_weather

检索全面的天气数据，包括当前天气状况、每小时天气预报和每日天气预报。

可用的具体数据：温度（当前温度、体感温度、最高/最低温度、热指数）、风（风速、阵风、风向）、天象（日出/日落、月相）、降水（类型、概率、降水量/QPF）、大气状况（紫外线指数、湿度、云量、雷暴概率）和地理编码位置地址。

位置和位置规则（重要）：使用“location”字段指定请求天气数据的位置。此字段是一个“oneof”结构，这意味着您必须为以下三个位置子字段中的**一个** 提供值，以确保准确查找天气数据。

地理坐标 (lat_lng)
- 当您获得确切的纬度/经度坐标时，请使用此字段。
- 示例："lat_lng": { "latitude": 34.0522, "longitude": -118.2437 } // 洛杉矶
地点 ID (place_id)
- 一个明确的字符串标识符（Google 地图地点 ID）。
- 您可以从 search_places 工具中获取 place_id。
- 示例："place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0" // 埃菲尔铁塔
地址字符串 (address)
- 一个自由格式的字符串，需要具体说明才能进行地理编码。
- 城市和区域：请始终添加区域/国家/地区（例如“London, UK”，而不是“London”）。
- 街道地址：请提供完整地址（例如“1600 Pennsylvania Ave NW, Washington, DC”）。
- 邮政编码：必须附带国家/地区名称（例如“90210, USA”，而不是“90210”）。

使用模式： 1. 当前天气：仅提供 address。请勿指定 date 和 hour。

每小时天气预报：提供 address、date 和 hour (0-23)。适用于特定时间（例如“下午 5 点”）或“未来几个小时”或“今天晚些时候”等术语。如果用户指定了分钟，请向下舍入到最接近的小时。不支持从现在起 48 小时后的每小时天气预报。
每日天气预报：提供 address 和 date。请勿指定 hour。适用于一般日期请求（例如“明天的天气”“周五的天气”“12/25 的天气”）。如果上下文中没有今天的日期，您应向用户说明。不支持包括今天在内的 7 天后的每日天气预报。不支持历史天气。

参数限制： * 时区：所有 date 和 hour 输入都必须相对于 位置的当地时区 ，而不是用户的时区。

日期格式：输入必须分为 {year, month, day} 整数。
单位：默认为 METRIC。如果用户暗示使用美国标准或明确要求使用美国标准，请将 units_system 设置为 IMPERIAL 以使用华氏度/英里。

compute_routes

计算指定出发地和目的地之间的行程路线。支持的出行方式： DRIVE（默认）、WALK。

输入要求（重要）：需要出发地 和目的地 。必须使用以下方法之一在各自的字段中嵌套提供每个字段：

address：（字符串，例如“Eiffel Tower, Paris”）。注意：输入地址越精细或具体，结果就越好。
lat_lng:：（对象，{"latitude": number, "longitude": number}）
place_id:：（字符串，例如“ChIJOwE_Id1w5EAR4Q27FkL6T_0”）注意：此 ID 可从 search_places 工具中获取。允许使用任何输入类型组合（例如，按地址作为出发地，按 lat_lng 作为目的地）。如果缺少出发地或目的地，您必须先询问用户以进行澄清 ，然后再尝试调用该工具。

工具调用示例： {"origin":{"address":"Eiffel Tower"},"destination":{"place_id":"ChIJt_5xIthw5EARoJ71mGq7t74"},"travel_mode":"DRIVE"}

获取 MCP 工具规范

如需获取 MCP 服务器中所有工具的 MCP 工具规范，请使用 tools/list 方法。下面的示例演示了如何使用 curl 列出 MCP 服务器中当前可用的所有工具及其规范。

Curl 请求
curl --location 'https://mapstools.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }'

Curl 请求

                      curl --location 'https://mapstools.googleapis.com/mcp' \
--header 'content-type: application/json' \
--header 'accept: application/json, text/event-stream' \
--data '{
    "method": "tools/list",
    "jsonrpc": "2.0",
    "id": 1
}'

MCP Reference: mapstools.googleapis.com 使用集合让一切井井有条 根据您的偏好保存内容并对其进行分类。

服务器设置

服务器端点

MCP 工具

获取 MCP 工具规范

MCP Reference: mapstools.googleapis.com