Aidenyangx Mapbox MCP Server

🚀 Mapbox MCP 服務器

Mapbox MCP 服務器是專為 Mapbox API 服務打造的服務器，能為用戶提供導航與搜索等多樣化功能，助力用戶更高效地使用 Mapbox 的相關服務。

🚀 快速開始

本服務器為 Mapbox API 提供服務，具備導航和搜索等實用工具，可幫助用戶獲取路線信息、計算出行矩陣以及搜索地點等。

✨ 主要特性

導航工具

1. mapbox_directions
   • 功能：獲取座標之間的路線信息。
   • 輸入：
     • coordinates ({latitude: number, longitude: number}[])：座標數組。
     • profile（可選）： "driving-traffic", "driving", "walking", "cycling"，代表不同的出行方式。
   • 返回：包含步驟、距離和持續時間的路線詳情。
2. mapbox_directions_by_places
   • 功能：使用地點名稱獲取路線信息。
   • 輸入：
     • places（字符串數組）：地名數組。
     • profile（可選）： "driving-traffic", "driving", "walking", "cycling"，代表不同的出行方式。
     • language（可選）：兩位字母語言代碼（例如："zh"，"en"）。
   • 返回：
     • 每個地點的地理編碼結果。
     • 路線詳情，包括步驟、距離和持續時間。
     • 處理過程中出現的任何錯誤。
3. mapbox_matrix
   • 功能：計算座標之間的出行時間和距離矩陣。
   • 輸入：
     • coordinates ({latitude: number, longitude: number}[])：座標數組。
     • profile（可選）： "driving", "walking", "cycling"，代表不同的出行方式。
     • annotations（可選）： "duration", "distance", "duration,distance"，指定返回的信息。
     • sources（可選）：源座標索引。
     • destinations（可選）：目標座標索引。
   • 返回：時長和/或距離的矩陣。
4. mapbox_matrix_by_places
   • 功能：使用地名名稱計算出行時間和距離矩陣。
   • 輸入：
     • places（字符串數組）：地名數組（2 - 25 個地點）。
     • profile（可選）： "driving", "walking", "cycling"，代表不同的出行方式。
     • annotations（可選）： "duration", "distance", "duration,distance"，指定返回的信息。
     • language（可選）：兩位字母語言代碼。
     • sources（可選）：源地點索引。
     • destinations（可選）：目標地點索引。
   • 返回：
     • 每個地點的地理編碼結果。
     • 時長和/或距離的矩陣。
     • 處理過程中出現的任何錯誤。

搜索工具

1. mapbox_search
   • 功能：根據查詢參數搜索地點信息。
   • 輸入：
     • query（字符串）：搜索關鍵詞。
     • longitude（數字）：經度座標。
     • latitude（數字）：緯度座標。
   • 返回：包含匹配地點的列表。

可視化展示

• 類圖：
• 流程圖：

🔧 技術細節

錯誤處理

所有工具都實現了全面的錯誤處理，涵蓋以下幾種常見錯誤類型：

• 輸入驗證錯誤
• API 請求失敗
• 速率限制錯誤
• 特定服務錯誤（例如，未找到路線、無效座標）

📄 許可證

此 MCP 服務器根據 MIT License 授權。這意味著您可以自由使用、修改和分發軟件，但需遵守 MIT License 的條款和條件。更多詳情，請參閱項目存儲庫中的 LICENSE 文件。