Mapbox MCP Server

用于Mapbox API的MCP服务器。

功能

导航工具

1. mapbox_directions

   • 获取坐标之间的路线
   • 输入：
     • coordinates ({latitude: number, longitude: number}[])
     • profile (可选): "driving-traffic", "driving", "walking", "cycling"
   • 返回：包含步骤、距离和时间的路线详情

2. mapbox_directions_by_places

   • 使用地点名称获取路线
   • 输入：
     • places (string[]): 地点名称数组
     • 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 (string[]): 地点名称数组（2-25个地点）
     • profile (可选): "driving", "walking", "cycling"
     • annotations (可选): "duration", "distance", "duration,distance"
     • language (可选): 两字母语言代码
     • sources (可选): 源地点的索引
     • destinations (可选): 目标地点的索引
   • 返回：
     • 每个地点的地理编码结果
     • 持续时间和/或距离矩阵
     • 处理过程中发生的任何错误

搜索工具

1. mapbox_geocoding
   • 搜索地点并将地址转换为坐标
   • 输入：
     • searchText (string): 要搜索的地点或地址
     • limit (可选): 最大结果数（1-10）
     • types (可选): 按地点类型过滤（国家、地区、地点等）
     • language (可选): 两字母语言代码
     • fuzzyMatch (可选): 启用/禁用模糊匹配
   • 返回：包括坐标和属性的详细位置信息

Claude Desktop集成

将此配置添加到您的Claude Desktop配置文件中（通常位于~/Library/Application Support/Claude/claude_desktop_config.json）：

json
{
"mcpServers": {
"mapbox-mcp-server": {
"command": "node",
"args": ["/absolute/path/to/mapbox-mcp-server/build/index.js"],
"env": {
"MAPBOX_ACCESS_TOKEN": "your-api-key"
}
}
}
}

设置

前提条件

• Node.js 16或更高版本
• TypeScript 4.5或更高版本
• 有效的Mapbox API密钥

API密钥

按照此处的说明获取Mapbox API密钥。

将您的API密钥设置为环境变量：

bash
export MAPBOX_ACCESS_TOKEN=your_api_key_here

请求限制

• 方向API：每分钟300次请求
• 矩阵API：
  • 驾车/步行/骑行：每分钟60次请求
  • 驾车交通：每分钟30次请求
• 地理编码API：每分钟600次请求

部署

结构

在mapbox-mcp-server中，我们使用以下结构来管理服务器的处理程序：

• src/server/handlers/base.ts: 所有处理程序的基类
• src/server/registry.ts: 所有处理程序的注册表
• src/server/main.ts: 服务器的主入口点

每个功能模块遵循以下结构：

plaintext
src/
├── types/ # 类型定义
├── schemas/ # 用于验证的Zod模式
├── tools/
│ ├── definitions/ # 工具定义
│ └── handlers/ # 工具实现
└── server/
└── handlers/ # 处理程序类---

类图:

流程图:

错误处理

所有工具都实现了全面的错误处理：

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

许可证

此 MCP 服务器采用 MIT 许可证。这意味着您可以自由使用、修改和分发该软件，但需遵守 MIT 许可证的条款和条件。更多详细信息，请参阅项目仓库中的 LICENSE 文件。