MCP Reference: mapstools.googleapis.com

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

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

伺服器端點

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

mapstools.googleapis.com MCP 伺服器具有下列 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。
lookup_weather

提供任何地點的目前天氣狀況、每小時和每日預報。如要提出天氣相關問題，請使用這項工具。

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

輸入規定 (重要)：

  • 目前狀況：只需要位置資訊 (例如城市或地址)。請勿指定日期或小時。

  • 每小時天氣預報：需要位置資訊和小時 (0-23)。如果使用者詢問特定時間的天氣，或使用「接下來幾小時」或「今天稍晚」等字詞，請使用這個意圖。

  • 每日預報：必須提供位置和完整日期。

日期處理 (重要)：使用者提供的日期和時間必須以所要求地點的當地時區為準。日期必須分成不同的整數參數：年、月和日。這些參數的必要格式為：{"year": , "month": , "day": }
compute_routes

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

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

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

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