Amazon Location Service MCP Server

Amazon Location Service MCP Server

Amazon Location Service MCP 伺服器是一個輕量級的 MCP 伺服器，它使 AI 助手和應用程式能夠通過標準化的端點訪問即時的 AWS 地理空間功能，包括地點搜索、地址編碼、反向地址編碼和路徑優化。它允許大型語言模型 (LLM) 程式化地與 Amazon Location Service 互動，為各種代理工作流程帶來動態位置智慧和自動化。

Author: awslabs


查看協議

什麼是 Amazon Location Service MCP 伺服器？

Amazon Location Service MCP 伺服器是模型上下文協議 (MCP) 的一種實現，連接 LLM 驅動的工具和助手到 Amazon Location Service API。通過這個伺服器，AI 代理可以搜索地點、進行地址編碼和反向編碼、計算路徑，並利用其他 AWS 地理空間功能。它在 LLM 環境與 AWS 的強大位置平台之間提供了一個可擴展的橋樑，促進了對話和自動化工具基於場景的集成。

如何配置 Amazon Location Service MCP 伺服器

  1. 先決條件

    • 確保您已安裝來自 Astral 的 uv。
    • 安裝 Python（例如：uv python install 3.10）。
    • 配置您的 AWS 憑證（訪問金鑰或 AWS 配置文件），並賦予 Amazon Location Service 的權限。

  2. MCP 伺服器配置示例

    • 將 Amazon Location Service MCP 伺服器條目添加到您的 MCP 客戶端配置文件中（例如：~/.aws/amazonq/mcp.json、.cursor/mcp.json 等）：

      {
  "mcpServers": {
    "awslabs.aws-location-mcp-server": {
      "command": "uvx",
      "args": [
        "awslabs.aws-location-mcp-server@latest"
      ],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "us-east-1",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}

  3. 環境變數

    • 根據需要設置 AWS_PROFILE 和 AWS_REGION。
    • 對於容器化部署，通過 --env 或 --env-file 來傳遞憑證。

  4. 啟用

    • 確保 MCP 伺服器已啟用（在您的配置中未標記為 "disabled": true）。

  5. 選項

    • 您可以根據組織的安全最佳實踐自定義日誌級別或使用基於角色的身份驗證。

如何使用 Amazon Location Service MCP 伺服器

  1. 發現可用工具

    • 使用 MCP 客戶端界面或 API 通過 tools/list 端點列出工具。這將顯示基於位置的功能，例如地點搜索和地址編碼。

  2. 調用位置工具

    • 通過 tools/call 端點和相關參數調用工具。例如，通過提供查詢和可選過濾器來進行地點搜索；通過提供起點和終點坐標來獲取路徑指引。

  3. 工作流程中的典型步驟

    • 在集成了 LLM 的 IDE 或聊天應用中，提示助手利用 Amazon Location Service MCP 工具進行以下任務：
      • "搜尋我辦公室附近的咖啡廳。"
      • "將此地址轉換為緯度/經度。"
      • "從這裡到機場的最佳路徑是什麼？"

  4. 客戶端中的工具批准

    • 如果提示，批准工具調用（許多客戶端提供自動批准選項，以簡化工作流程）。

  5. 檢查結果

    • AI 助手或自動化管道將接收結構化響應（例如，地點列表、坐標結果、路徑詳細信息）以便進一步處理、顯示、代碼生成或商業邏輯執行。

  6. 範例命令行用法

    • 手動運行 MCP 伺服器進行測試： 
      timeout 15s uv tool run awslabs.aws-location-mcp-server --region us-east-1 2>&1 || echo "完成或超時"

主要特點

  • 無縫地點搜索：查詢支持的 AWS 數據提供者的商業名稱、地標和地址。
  • 地址編碼與反向編碼：在地址和緯度/經度坐標之間轉換。
  • 路徑優化：計算最佳路徑、預估旅行時間和距離，涵蓋地圖數據。
  • MCP 工具發現：直接提供標準化、文檔化的功能，供 LLM 代理使用。
  • 安全的 AWS 集成：利用 IAM 角色和政策，控制對位置查詢和服務的訪問。
  • 低延遲的本地或雲部署：在本地運行 MCP 伺服器以保持私密性，或在遠程運行以實現隨時可用和可擴展的使用。
  • 可擴展和可配置：根據應用或組織需求成長，調整端點和服務。

使用案例

  • 對話式助手：使 LLM 驅動的聊天機器人回答用戶位置問題，執行即時地點查詢，或建議商業和興趣點。
  • 現場服務自動化：自動生成指引，優化外勤路徑並通過地理空間 API 進行調度，並將結果顯示在 AI 驅動的儀表板或工作流程中。
  • 客戶體驗代理：幫助用戶查找商店位置、驗證地址或查看商業時間，使用自然語言。
  • 應用開發：將地理編碼、路線規劃和接近搜索整合為網頁/移動應用的後端邏輯的一部分。
  • 數據標註：地理標註非結構化地址，或用精確坐標對數據集進行標註，以便分析和可視化。

常見問題解答

Q1：使用 Amazon Location Service MCP 伺服器需要哪些 AWS 權限？
A1：所用的 AWS 憑證或配置文件必須獲授權以訪問 Amazon Location Service 行動，例如 geo:SearchPlaceIndexForText、geo:CalculateRoute 和您打算暴露的任何其他位置 API 行動。

Q2：我可以按地理區域或數據提供者限制響應嗎？
A2：可以，MCP 伺服器支持參數來指定區域、邊界框、數據提供者或根據 Amazon Location Service API 配置的自定義過濾器。

Q3：這個伺服器是否儲存或記錄任何位置數據？
A3：預設情況下，伺服器不會持久化或記錄敏感的位置查詢或響應。可以調整日誌級別以進行調試，但建議檢查設置以確保隱私合規。

Q4：我可以離線運行 Amazon Location Service MCP 伺服器嗎？
A4：雖然伺服器可以本地運行，但必須連接到 AWS 以提供即時位置數據。可能會實施一些有限的緩存，但大多數功能需要網絡訪問。

Q5：如何在我的 LLM 助手中使用這些位置工具？
A5：配置完成後，只需提示 AI 助手使用所需的位置工具，或者讓 LLM 在處理地理空間查詢時自動選擇相關工具。批准和結果通過客戶端界面管理。