JinDaGe - mapbox-mcp-server MCP Details

article

README

🚀 Mapbox MCP 服务器

Mapbox MCP 服务器是专门为 Mapbox API 打造的工具，能提供丰富的导航、验证及错误处理功能，助力开发者高效使用 Mapbox API。

✨ 主要特性

导航工具

mapbox_directions
- 功能：根据坐标获取导航路线。
- 输入参数：
  - coordinates ({latitude: number, longitude: number}[])：坐标数组。
  - profile（可选）：支持 "driving-traffic"、"driving"、"walking"、"cycling" 等出行模式。
- 返回结果：包含步骤、距离和时长的路由信息。
mapbox_directions_by_places
- 功能：根据地名获取导航路线。
- 输入参数：
  - places（字符串数组）：地名数组。
  - profile（可选）：支持 "driving-traffic"、"driving"、"walking"、"cycling" 等出行模式。
  - language（可选）：两位字母语言代码（例如 "zh"、"en"）。
- 返回结果：
  - 每个地点的地理编码结果。
  - 路由详细信息，包括步骤、距离和时长。
  - 处理过程中出现的任何错误。
mapbox_matrix
- 功能：计算坐标点之间的出行时间和距离矩阵。
- 输入参数：
  - coordinates ({latitude: number, longitude: number}[])：坐标数组。
  - profile（可选）：支持 "driving"、"walking"、"cycling" 等出行模式。
  - annotations（可选）：支持 "duration"、"distance"、"duration,distance" 等标注类型。
  - sources（可选）：源坐标点的索引。
  - destinations（可选）：目标坐标点的索引。
- 返回结果：时长和/或距离的矩阵。
mapbox_matrix_by_places
- 功能：根据地名计算出行时间和距离矩阵。
- 输入参数：
  - places（字符串数组）：地名数组（2 - 25 个地点）。
  - profile（可选）：支持 "driving"、"walking"、"cycling" 等出行模式。
  - annotations（可选）：支持 "duration"、"distance"、"duration,distance" 等标注类型。
  - language（可选）：两位字母语言代码。
  - sources（可选）：源地点的索引。
  - destinations（可选）：目标地点的索引。
- 返回结果：
  - 每个地点的地理编码结果。
  - 距离矩阵数据。
  - 处理过程中出现的任何错误。

输入验证工具

mapbox_input_validation
- 功能：验证输入参数的有效性。
- 支持的验证类型：required、string、integer、number、boolean、array、object。
- 返回结果：
  - 有效的输入数据。
  - 验证失败时的具体错误信息。

其他工具

mapbox_error_handling
- 功能：处理各种异常情况。
- 支持的错误类型：input_error、api_request_failure、rate_limit_exceeded、service_specific_error。
- 返回结果：
  - 错误代码。
  - 错误信息。
  - 建议解决方案。

💻 使用示例

Claude 桌面集成

{
  "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"
    ]
  }
}

📦 安装指南

环境配置

安装依赖项：

npm install mapbox-mcp-server express validator

配置环境变量：

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

📚 详细文档

部署结构

类图：
流程图：

错误处理

所有工具均实现全面的错误处理机制，可处理以下错误：

输入验证失败
API 请求失败
速率限制错误
服务特定错误（例如无可用路线、无效坐标）

📄 许可证

本 MCP 服务器根据 MIT License 分发。这意味着您可以自由地使用、修改和分发软件，但需遵守 MIT 许可证的条款和条件。更多详情，请参阅项目存储库中的 LICENSE 文件。

mapbox-mcp-server