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