MCP Reference: mapstools.googleapis.com

Model Context Protocol (MCP) 伺服器可做為代理伺服器，在外部服務與大型語言模型 (LLM) 或 AI 應用程式之間傳輸脈絡、資料或功能。MCP 伺服器可將 AI 應用程式連結至資料庫和 Web 服務等外部系統，並將系統回覆轉換成 AI 應用程式可理解的格式。

伺服器設定

您必須先啟用 MCP 伺服器並設定驗證，才能使用這項功能。如要進一步瞭解如何使用 Google 和 Google Cloud 遠端 MCP 伺服器，請參閱 Google Cloud MCP 伺服器總覽。

這是 Maps Grounding Lite API 提供的 MCP 伺服器。伺服器提供工具，供開發人員在 Google 地圖平台之上建構 LLM 應用程式。

伺服器端點

MCP 服務端點是 MCP 伺服器的網路位址和通訊介面 (通常是網址)，AI 應用程式 (MCP 用戶端的主機) 會使用這個端點建立安全標準連線。這是 LLM 請求內容、呼叫工具或存取資源的聯絡點。Google MCP 端點可以是全域或區域。

Maps Grounding Lite API MCP 伺服器具有下列 MCP 端點：

  • https://mapstools.googleapis.com/mcp

MCP 工具

MCP 工具是 MCP 伺服器向 LLM 或 AI 應用程式公開的函式或可執行功能，可在現實世界中執行動作。

mapstools.googleapis.com MCP 伺服器提供下列工具：

MCP 工具
search_places

當使用者要求尋找地點、商家、地址、位置、景點或任何其他 Google 地圖相關搜尋時，請呼叫這項工具。

輸入規定 (重要)：

  1. 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')。

  2. 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)。

  3. language_code (字串 - 選用)：顯示搜尋結果摘要的語言。

    • 格式：兩個字母的語言代碼 (ISO 639-1)，後面可選擇加上底線和兩個字母的國家/地區代碼 (ISO 3166-1 alpha-2)，例如 en、ja、en_US、zh_CN、es_MX。如未提供語言代碼，結果會以英文顯示。

  4. region_code (字串 - 選用)：使用者的 Unicode CLDR 區域代碼。這個參數用於顯示地點詳細資料，例如特定區域的地點名稱 (如有)。根據適用法律，這項參數可能會影響結果。

    • 格式：由兩個英文字母組成的國家/地區代碼 (ISO 3166-1 alpha-2)，例如 US、CA。

工具呼叫的指示：

  • 位置資訊 (重要)：搜尋內容必須包含足夠的位置資訊。如果地點不明確 (例如只有「披薩店」)，請務必在 text_query 中指定地點 (例如「紐約的披薩店」)，或使用 location_bias 參數。如需消歧，請加入城市、州/省和區域/國家/地區名稱。

  • 請盡量提供最具體且符合當下情境的text_query資訊。

  • 只有在明確提供座標，或從使用者已知情境推斷位置資訊是適當且有助於提升結果品質時，才使用 location_bias。

  • 如有 attribution 欄位資訊，系統必須使用該資訊將基礎輸出內容歸因於來源。
lookup_weather

擷取完整的天氣資料，包括目前天氣狀況、每小時和每日預報。

可用的特定資料：溫度 (目前、體感、最高/最低、熱指數)、風 (風速、陣風、風向)、天象 (日出/日落、月相)、降水 (類型、機率、量/QPF)、大氣狀況 (紫外線指數、濕度、雲量、雷雨機率) 和地理編碼位置地址。

位置和位置規則 (重要)：

使用 location 欄位指定要求天氣資料的位置。這個欄位是「oneof」結構，也就是說，您「必須」只為下列三個位置子欄位中的「其中一個」提供值，確保天氣資料查詢結果準確無誤。

  1. 地理座標 (lat_lng)

    • 如果已取得確切的經緯度座標，請使用這個方法。
    • 示例：{"location": {"lat_lng": {"latitude": 34.0522, "longitude": -118.2437}}} // Los Angeles

  2. 地點 ID (place_id)

    • 明確的字串 ID (Google 地圖地點 ID)。
    • 您可以透過 search_places 工具擷取 place_id。
    • Example: {"location": {"place_id": "ChIJLU7jZClu5kcR4PcOOO6p3I0"}} // Eiffel Tower

  3. 地址字串 (address)

    • 需要具體說明才能進行地理編碼的任意格式字串。
    • 城市和區域：請務必加上區域/國家/地區 (例如「英國倫敦」，而非「倫敦」)。
    • 街道地址：提供完整地址 (例如「1600 Pennsylvania Ave NW, Washington, DC」)。
    • 郵遞區號：必須附上國家/地區名稱 (例如「90210, USA」，而非「90210」)。
    • 例如：{"location": {"address": "1600 Pennsylvania Ave NW, Washington, DC"}}

使用模式：

  • 目前天氣：僅提供 location。請勿指定 date 和 hour。

  • 每小時天氣預報：提供 location、date 和 hour (0 到 23)。你可以指定時間 (例如「下午 5 點」)，也可以使用「接下來幾小時」或「今天稍晚」等字詞。如果使用者指定分鐘，則會四捨五入至最接近的小時。系統不支援超過 120 小時的每小時天氣預報。系統支援過去 24 小時的每小時天氣記錄。

  • 每日預報：提供 location 和 date。請勿指定 hour。用於一般日期要求 (例如「明天的天氣」、「星期五的天氣」、「12 月 25 日的天氣」)。如果對話內容未提及今天日期，請向使用者確認。系統不支援預測今天起 10 天後的每日用量。系統不支援歷史天氣資訊。

參數限制：

  • 時區：所有 date 和 hour 輸入內容都必須以地點的當地時區為準，而非使用者的時區。
  • 日期格式：輸入內容必須以 {year, month, day} 個整數分隔。
  • 單位：預設為 METRIC。如果使用者暗示採用美國標準或明確要求，請將 units_system 設為 IMPERIAL (華氏/英里)。

  • 如有 attribution 欄位資訊，系統必須使用該資訊將基礎輸出內容歸因於來源。
compute_routes

計算指定起點和目的地之間的路線。支援的交通方式：DRIVE (預設)、WALK。

輸入規定 (重要)：必須同時提供出發地和目的地。您必須使用下列其中一種方法，在各自的欄位中提供這些資訊：

  • address: (字串，例如「巴黎鐵塔」)。注意：輸入的地址越精細或具體，結果就越準確。

  • 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"}

  • 如有 attribution 欄位資訊，系統必須使用該資訊將基礎輸出內容歸因於來源。

取得 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
}'