关键词

地理编码路线规划地图生成位置搜索空间分析

项目简介

Mapbox MCP 服务器是一个基于 Model Context Protocol (MCP) 的官方实现，由 Mapbox 公司开发和维护。它通过标准化的MCP协议向各种AI客户端（如Claude Desktop、VS Code等）提供丰富的地理位置服务和地图功能。

主要功能

地理编码与搜索

  • 地址转坐标：将文字地址转换为精确的地理坐标
  • 反向地理编码：将地理坐标转换为可读的地址信息
  • 分类搜索：按类别（如餐厅、酒店、加油站等）查找周边地点
  • POI搜索：搜索特定名称的地点或商家

导航与路线规划

  • 多模式导航：支持驾车（含实时交通）、步行和骑行路线
  • 旅行时间矩阵：计算多个地点之间的通行时间和距离
  • 等时线分析：计算从某位置在指定时间内可达的区域

地图可视化

  • 静态地图生成：创建自定义的地图图像，支持多种样式和标记
  • 可达性分析：可视化特定时间范围内的服务覆盖区域

安装步骤

前置要求

  • Node.js 环境
  • 有效的 Mapbox 访问令牌（可在 mapbox.com 免费注册获取）

服务器配置

在支持MCP协议的客户端中配置服务器信息：

{
  "mcpServers": {
    "mapbox": {
      "command": "npx",
      "args": ["-y", "@mapbox/mcp-server"]
}

环境变量配置

设置 Mapbox 访问令牌作为环境变量：

export MAPBOX_ACCESS_TOKEN=你的访问令牌

或者直接在客户端配置中设置环境变量：

{
  "mcpServers": {
    "mapbox": {
      "command": "node",
      "args": ["/path/to/dist/esm/index.js"],
  "env": {
    "MAPBOX_ACCESS_TOKEN": "你的访问令牌"
}

基本使用方法

配置完成后，即可在支持MCP的客户端中使用各种地理空间功能：

位置发现

  • "查找帝国大厦附近的咖啡店"
  • "显示从波士顿到纽约沿途的加油站"

导航查询

  • "获取从洛杉矶机场到好莱坞的驾车路线（含实时交通）"
  • "计算从酒店到机场在高峰时段的通行时间"

地图生成

  • "创建显示金门大桥到渔人码头路线的地图图像"
  • "生成西雅图市中心一英里内所有星巴克位置的地图"

提示技巧

  • 使用具体地址或地标名称
  • 指定偏好的出行方式（驾车、步行、骑行）
  • 包含时间约束（"高峰时段"、"下午3点"等）
  • 请求特定输出格式（"作为地图图像"、"JSON格式"等）

高级特性

MCP-UI 支持

支持在兼容客户端中内嵌显示交互式地图界面。

资源访问

提供静态参考数据作为MCP资源，如分类列表，可通过MCP协议直接访问。

可观测性

内置 OpenTelemetry 追踪功能，支持多种云平台和SaaS服务的性能监控。

信息

分类

网页与API

访问项目