Mapbox MCP Server
2024.12.23
8
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 次请求（驾驶/步行/骑行），每分钟 30 次请求（驾驶交通）
- Geocoding API: 每分钟 600 次请求
使用教程
使用依赖
- Node.js 16 或更高版本
- TypeScript 4.5 或更高版本
- 有效的 Mapbox API 密钥
安装教程
- 获取 Mapbox API 密钥：Mapbox API Key
- 设置环境变量：
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" } } } }
调试方式
安装完成后，可以通过以下步骤进行调试：
1. 确保环境变量 MAPBOX_ACCESS_TOKEN 已正确设置。
2. 运行服务器并检查日志输出是否有错误信息。
3. 使用工具进行测试，确保返回结果符合预期。