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 文件。