Mapbox MCP Server

Mapbox MCP Server

site icon
2025.01.03 1
TypeScript地图服务导航工具地理编码位置服务
Mapbox MCP Server 是一个基于 Mapbox API 的服务,主要用于提供导航和地理编码功能。它支持多种导航工具和搜索工具,能够帮助用户获取路线、计算旅行时间和距离矩阵,以及进行地理编码搜索。该服务适用于需要地图和位置服务的应用场景,如导航应用、物流规划和位置搜索等。
View on GitHub

Overview

基本能力

产品定位

Mapbox MCP Server 是一个基于 Mapbox API 的服务,主要用于提供导航和地理编码功能。

核心功能

  1. 导航工具
  2. mapbox_directions: 获取坐标之间的路线详情,包括步骤、距离和持续时间。
  3. mapbox_directions_by_places: 通过地点名称获取路线详情。
  4. mapbox_matrix: 计算坐标之间的旅行时间和距离矩阵。
  5. mapbox_matrix_by_places: 通过地点名称计算旅行时间和距离矩阵。

  6. 搜索工具

  7. mapbox_geocoding: 搜索地点并将地址转换为坐标。

适用场景

  • 导航应用
  • 物流规划
  • 位置搜索
  • 旅行时间计算

工具列表

  1. mapbox_directions: 获取坐标之间的路线详情。
  2. mapbox_directions_by_places: 通过地点名称获取路线详情。
  3. mapbox_matrix: 计算坐标之间的旅行时间和距离矩阵。
  4. mapbox_matrix_by_places: 通过地点名称计算旅行时间和距离矩阵。
  5. mapbox_geocoding: 搜索地点并将地址转换为坐标。

常见问题解答

  • API 速率限制
  • Directions API: 每分钟 300 次请求。
  • Matrix API: 每分钟 60 次请求(driving/walking/cycling),每分钟 30 次请求(driving-traffic)。
  • Geocoding API: 每分钟 600 次请求。

使用教程

使用依赖

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

安装教程

  1. 获取 Mapbox API 密钥:Mapbox Access Tokens
  2. 设置环境变量: bash export MAPBOX_ACCESS_TOKEN=your_api_key_here
  3. 将以下配置添加到 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" } } } }

调试方式

  • 确保所有依赖已正确安装。
  • 检查环境变量 MAPBOX_ACCESS_TOKEN 是否已设置。
  • 运行服务并检查日志以确认服务是否正常启动。

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。