使用說明

項目簡介

這是一個基於 Model Context Protocol (MCP) 開發的伺服器，整合了 Google Maps 服務，為大型語言模型 (LLM) 提供豐富的地理位置相關工具能力。

主要功能點

本伺服器提供以下主要功能，可以透過 MCP 工具呼叫使用：

• 地點搜尋： 在指定地點附近搜尋特定類型的地點，可篩選半徑、是否營業中及最低評分。
• 地點詳細資訊： 根據 Google Maps 地點 ID 獲取詳細資料，如地址、評分、營業時間、電話、網站等。
• 地址與座標轉換： 將地址轉換為地理座標（經緯度），或將地理座標轉換為地址。
• 距離與時間計算： 計算多個起點和終點之間的距離與預計行程時間，支援不同交通模式（開車、步行、自行車、大眾運輸）。
• 路線規劃： 獲取兩點之間的詳細路線指引，支援不同交通模式。
• 海拔數據： 獲取指定地理位置的海拔高度。

安裝步驟

本伺服器是一個 Node.js 應用，可以透過 npm 安裝：

npm install -g @cablate/mcp-google-map

伺服器配置

MCP 伺服器通常由 MCP 客戶端 (如 Dive Desktop) 啟動和管理。要連接此伺服器，您的 MCP 客戶端需要配置其啟動命令及必要的環境變數。

基本的配置資訊如下：

• 伺服器名稱 (server name): 可以自定義一個識別名稱，例如 'google-map'。
• 啟動命令 (command): 'npx'
• 命令參數 (args): '-y', '@cablate/mcp-google-map'
• 環境變數 (env): 必須設定 'GOOGLE_MAPS_API_KEY' 環境變數，其值為您的 Google Maps API 金鑰。

注意：請根據您的 MCP 客戶端介面，以其要求的 JSON 或其他格式填寫上述配置資訊。您需要在 Google Cloud Platform 啟用 Google Maps API 並取得金鑰。

基本使用方法

安裝完成並設定好 Google Maps API 金鑰環境變數後，您可以直接從命令列啟動伺服器（主要用於測試或特定用途）：

mcp-google-map

更常見的使用方式是將此伺服器整合到支援 MCP 的客戶端應用中 (如 Dive Desktop)，由客戶端負責啟動和管理。一旦伺服器成功啟動並連接到客戶端，LLM 即可透過客戶端呼叫伺服器提供的 Google Maps 工具。