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 。不要把示例佔位金鑰寫進設定。未出現的工具名、路線規劃和配額數字都不要自行補全。