
Mapbox MCP Server

2025.01.03
1
TypeScript地图服务导航工具地理编码位置服务
Mapbox MCP Server 是一个基于 Mapbox API 的服务,主要用于提供导航和地理编码功能。它支持多种导航工具和搜索工具,能够帮助用户获取路线、计算旅行时间和距离矩阵,以及进行地理编码搜索。该服务适用于需要地图和位置服务的应用场景,如导航应用、物流规划和位置搜索等。
View on GitHub
Overview
基本能力
产品定位
Mapbox MCP Server 是一个基于 Mapbox API 的服务,主要用于提供导航和地理编码功能。
核心功能
- 导航工具
mapbox_directions
: 获取坐标之间的路线详情,包括步骤、距离和持续时间。mapbox_directions_by_places
: 通过地点名称获取路线详情。mapbox_matrix
: 计算坐标之间的旅行时间和距离矩阵。-
mapbox_matrix_by_places
: 通过地点名称计算旅行时间和距离矩阵。 -
搜索工具
mapbox_geocoding
: 搜索地点并将地址转换为坐标。
适用场景
- 导航应用
- 物流规划
- 位置搜索
- 旅行时间计算
工具列表
mapbox_directions
: 获取坐标之间的路线详情。mapbox_directions_by_places
: 通过地点名称获取路线详情。mapbox_matrix
: 计算坐标之间的旅行时间和距离矩阵。mapbox_matrix_by_places
: 通过地点名称计算旅行时间和距离矩阵。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 密钥
安装教程
- 获取 Mapbox API 密钥:Mapbox Access Tokens。
- 设置环境变量:
bash export MAPBOX_ACCESS_TOKEN=your_api_key_here
- 将以下配置添加到 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
是否已设置。 - 运行服务并检查日志以确认服务是否正常启动。