Mapbox MCP Server

简介

Mapbox MCP 服务器为 Claude 提供地图、导航和地点搜索功能。

主要功能

导航工具

• 获取路线：通过坐标或地点名称获取详细路线
• 距离矩阵：计算多个地点之间的时间和距离

搜索工具

• 地理编码：搜索地点并将地址转换为坐标

设置步骤

1. 安装要求

• Node.js 16+
• TypeScript 4.5+

2. 获取 API 密钥

1. 访问 Mapbox 控制台 创建 API 密钥
2. 设置环境变量：

   export MAPBOX_ACCESS_TOKEN=your_api_key_here
   

3. 集成到 Claude Desktop

编辑配置文件 (~/Library/Application Support/Claude/claude_desktop_config.json):

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

使用方法示例

获取路线

// 使用坐标获取路线
const result = await mapbox_directions({
  coordinates: [
    {latitude: 37.7749, longitude: -122.4194},
    {latitude: 34.0522, longitude: -118.2437}
  ],
  profile: "driving"
});

// 使用地点名称获取路线
const result = await mapbox_directions_by_places({
  places: ["旧金山", "洛杉矶"],
  profile: "driving",
  language: "zh"
});

计算距离矩阵

// 使用地点名称计算矩阵
const matrix = await mapbox_matrix_by_places({
  places: ["纽约", "波士顿", "华盛顿特区"],
  profile: "driving",
  annotations: "duration,distance"
});

地点搜索

const places = await mapbox_geocoding({
  searchText: "埃菲尔铁塔",
  limit: 3,
  language: "zh"
});

请求限制

• 方向 API：300 次/分钟
• 矩阵 API：60 次/分钟（标准）；30 次/分钟（交通）
• 地理编码 API：600 次/分钟

错误处理

所有工具都包含全面的错误处理，包括输入验证、API 请求失败和服务特定错误。

许可证

MIT 许可证