Mapbox MCP Server

🚀 Mapbox MCP 服務器

Mapbox MCP 服務器是專門為 Mapbox API 打造的工具，它提供了豐富的導航、輸入驗證等功能，能幫助開發者更高效地使用 Mapbox API。

🚀 快速開始

要使用 Mapbox MCP 服務器，您需要完成以下環境配置步驟：

1. 安裝依賴項：

   npm install mapbox-mcp-server express validator
   

2. 配置環境變量：

   process.env.NODE_ENV = 'production';
   process.env.MAPBOX_API_KEY = 'your_api_key_here';
   

✨ 主要特性

導航工具

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_input_validation
   • 功能：驗證輸入參數的有效性。
   • 支持的驗證類型：required、string、integer、number、boolean、array、object。
   • 返回結果：
     • 有效的輸入數據。
     • 驗證失敗時的具體錯誤信息。

其他工具

1. mapbox_error_handling
   • 功能：處理各種異常情況。
   • 支持的錯誤類型：input_error、api_request_failure、rate_limit_exceeded、service_specific_error。
   • 返回結果：
     • 錯誤代碼。
     • 錯誤信息。
     • 建議解決方案。

💻 使用示例

基礎用法

以下是在Claude桌面集成中使用Mapbox MCP服務器的示例配置：

{
  "name": "mapbox_mcp_server",
  "description": "Mapbox API 的 MCP 服務器工具集",
  "version": "1.0.0",
  "parameters": {
    "api_key": {
      "type": "string",
      "required": true,
      "description": "Mapbox API 的訪問密鑰"
    },
    "tools": [
      "mapbox_directions",
      "mapbox_directions_by_places",
      "mapbox_matrix",
      "mapbox_matrix_by_places",
      "mapbox_input_validation",
      "mapbox_error_handling"
    ]
  }
}

📚 詳細文檔

部署結構

• 類圖：
• 流程圖：

錯誤處理

所有工具均實現全面的錯誤處理機制，可處理以下錯誤情況：

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

📄 許可證

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