Mapbox MCP Server

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

📦 安装指南

环境配置

1. 安装依赖项：

npm install mapbox-mcp-server express validator

2. 配置环境变量：

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

📚 详细文档

部署结构

• 类图：
• 流程图：

错误处理

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

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

📄 许可证

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