Mapbox

官方

通过Mapbox API解锁地理空间智能,包括地理编码、兴趣点搜索、路线规划、等时线等功能。

你可以用 Mapbox MCP 做什么?

  • 搜索和地理编码地点 — 通过 search_and_geocode_tool 查询地址、兴趣点或地标,支持可选类别过滤和语言设置。
  • 获取逐向导航 — 使用 directions_tool 请求驾车、步行或骑行路线,支持实时交通、途经点和排除项。
  • 在实时地图上可视化结果 — 利用 render_map_tool 在聊天中显示路线、搜索结果或自定义 GeoJSON 的交互式地图。
  • 运行离线地理空间计算 — 使用 distance_toolbuffer_tool 等工具在本地计算距离、面积、方位角、缓冲区和质心,无需调用 API。
  • 将 GPS 轨迹匹配到道路 — 通过 map_matching_tool 清理嘈杂坐标并将其匹配到道路网络,支持可选时间戳。
  • 优化多站点路线 — 使用 optimization_tool 解决最多 12 个地点的旅行商问题,支持往返或单程行程。

文档

Mapbox MCP 服务器

npm version

基于 Node.js 的服务器,为 Mapbox API 实现模型上下文协议(MCP)。

为您的 AI 应用解锁地理空间智能

Mapbox MCP 服务器通过无缝访问 Mapbox 全面的位置智能平台,将任何 AI 代理或应用转变为具备地理空间感知能力的系统。借助此服务器,您的 AI 能够理解并推理地点、导航物理世界,并访问丰富的地理空间数据,包括:

  • 全球地理编码,将地址和地名转换为坐标,反之亦然
  • 兴趣点(POI)搜索,覆盖全球数百万家企业、地标和地点
  • 多模式路线规划,支持驾车、步行和骑行,并包含实时交通信息
  • 出行时间矩阵,用于分析可达性和优化物流
  • 路线优化,为多个停靠点找到最优访问顺序(旅行商问题)
  • 地图匹配,将 GPS 轨迹匹配到道路网络,实现清晰的路线可视化
  • 等时线生成,可视化在特定时间或距离限制内可到达的区域
  • 实时交互式地图渲染render_map_tool),在聊天界面内直接通过真实的 Mapbox GL JS 地图显示路线、搜索结果以及您自己的自定义 GeoJSON
  • 静态地图图像,用于创建位置、路线和地理数据的可视化表示
  • 离线地理空间计算,支持距离、面积、方位角、缓冲区及空间分析,无需调用 API

无论您是在构建 AI 旅行助手、物流优化器、基于位置的推荐系统,还是任何需要理解“在哪里”的应用,Mapbox MCP 服务器都能提供实现这一切所需的空间智能。您还可以在 Claude Desktop 和 VS Code 等流行客户端上启用它。详见下文。

Mapbox MCP Server Demo

使用方法

使用此 MCP 服务器需要 Mapbox 访问令牌。

托管 MCP 端点

如需快速访问,您可以使用我们的托管 MCP 端点:

端点https://mcp.mapbox.com/mcp

有关不同客户端的详细设置说明和 API 用法,请参阅托管 MCP 服务器指南

要获取 Mapbox 访问令牌:

  1. mapbox.com/signup 免费注册 Mapbox 账户
  2. 导航至您的账户页面
  3. 创建新令牌或使用默认的公共令牌

有关 Mapbox 访问令牌的更多信息,请参阅 Mapbox 访问令牌文档

集成指南

有关不同集成的详细设置说明,请参阅以下指南:

  • Claude Desktop 设置 - 配置 Claude Desktop 以使用此 MCP 服务器的说明
  • Goose 设置 - 设置 Goose AI 代理框架
  • VS Code 设置 - 在 Visual Studio Code 中设置开发环境
  • Cursor AI IDE 设置 - 在 Cursor AI IDE 中设置开发环境
  • Smolagents 集成 - 展示如何将 Smolagents AI 代理连接到 Mapbox 工具的示例
  • 直接导入工具 - 在不运行 MCP 服务器的情况下,在您自己的应用中使用 Mapbox 工具
  • render_map_tool 指南 - 地图可视化原语:完整载荷模式以及如何独立渲染您自己的数据,无需任何其他 Mapbox 工具
  • Elicitations - search_and_geocode_tooldirections_tool 如何要求用户消除结果歧义或选择路线,以及在客户端不支持时如何优雅降级

示例提示词

设置完成后,可尝试在 Claude Desktop 或其他 MCP 客户端中使用以下提示词:

位置锚定

对于以坐标优先的查询——例如“我附近有什么”、“这是什么街区”、“N 分钟内能到达哪里”——请使用 ground_location_tool。它通过一次调用组合了反向地理编码、类别搜索和等时线,根据查询自适应地选择正确策略,并返回带引用的类型化记录(名称、地址、坐标、距离、可达性多边形)。

以下四个提示词分别在一个工具调用中演练了不同策略:

  • 街区 — “47.6097, -122.3408 是什么街区,我周围有什么?”
  • 兴趣点 — “40.7580, -73.9855 步行 10 分钟内的咖啡店”
  • 区域 — “从 37.7749, -122.4194 步行 15 分钟能到达哪里?”
  • 路线 — “距离 34.0522, -118.2437 最近的可下车路线点”

位置发现

  • “查找帝国大厦步行范围内的咖啡店”
  • “我想从西雅图去波特兰,沿途有星巴克吗?”
  • “显示从波士顿到纽约沿途的加油站”
  • “时代广场附近有哪些餐厅?”

导航与出行

  • “获取从洛杉矶国际机场到好莱坞的驾车路线,包含当前交通状况”
  • “从中央公园步行到时代广场需要多长时间?”
  • “计算高峰时段从我的酒店(四季酒店)打车到肯尼迪机场的出行时间”

可视化与地图

  • “使用 Mapbox 地图渲染工具,显示从金门大桥到旧金山联合广场的路线”——在真实的 Mapbox 地图上渲染实时交互式路线
  • “创建一张地图图像,显示从金门大桥到渔人码头的路线,并在两个位置添加标记”
  • “显示曼哈顿的卫星视图,并标注关键地标”
  • “生成一张地图,突出显示西雅图市中心一英里范围内的所有星巴克门店”
  • “在这些坐标上显示填充多边形:[...],并在 [...] 处添加标记‘仓库’”——直接通过 render_map_tool 渲染您自己的 GeoJSON,无需其他 Mapbox 工具

分析与规划

  • “显示波特兰市中心驾车 30 分钟内可到达的区域”
  • “计算丹佛这 3 家酒店(万豪、喜来登和希尔顿)与会展中心之间的出行时间矩阵”
  • “为旧金山这 3 个旅游景点(金门大桥、音乐阶梯和渔人码头)找到最优访问路线”
  • “为这 8 个地址优化配送路线:[地址列表]”

GPS 与路线匹配

  • “清理此 GPS 轨迹,并显示道路上的实际路线:[带时间戳的坐标列表]”
  • “将这段记录的骑行轨迹匹配到骑行网络:[GPS 坐标]”
  • “将此驾车路线匹配到道路网络,并显示交通拥堵程度”

离线地理空间计算

  • “这两个坐标之间的距离是多少英里?”
  • “计算这个多边形以平方公里为单位的面积”
  • “点 37.7749°N, 122.4194°W 是否在此服务区域多边形内?”
  • “从旧金山到纽约的方位角是多少?”
  • “找到伦敦和巴黎之间的中点”
  • “在此位置周围创建 5 英里缓冲区”
  • “计算此街区边界的质心”
  • “这些路线坐标的边界框是什么?”
  • “简化这个复杂多边形以减少点数”

获得更好结果的提示

  • 对位置要具体(使用完整地址或地标名称)
  • 指定您偏好的出行方式(驾车、步行、骑行)
  • 在相关时包含时间限制(“高峰时段”、“下午 3 点”)
  • 在需要时要求特定输出格式(“作为地图图像”、“以 JSON 格式”)

详细示例: 请参阅 examples/search-along-route.md,了解搜索沿途路线提示词在不同用例下的综合示例以及 MCP Inspector 测试说明。

资源

MCP 服务器将静态参考数据作为 MCP 资源 暴露。资源提供只读数据访问,客户端无需调用工具即可直接引用。

可用资源

Mapbox 类别资源

URI 模式mapbox://categoriesmapbox://categories/{language}

访问可用于类别搜索工具的完整类别 ID 列表。类别可用于按类型过滤搜索结果(例如“restaurant”、“hotel”、“gas_station”)。

示例

  • mapbox://categories - 默认(英文)类别列表
  • mapbox://categories/ja - 日文类别名称
  • mapbox://categories/es - 西班牙文类别名称

访问资源

  • 支持原生 MCP 资源的客户端:使用 resources/read MCP 协议方法
  • 不支持资源的客户端:使用 resource_reader_tool 配合资源 URI

丰富地图预览(render_map_tool

此服务器中的每个地理空间工具(路线规划、等时线、搜索等)都可以通过 render_map_tool 将结果显示为实时交互式 Mapbox GL JS 地图——这是服务器的单一可视化原语。它通过 MCP Apps 协议(@modelcontextprotocol/ext-apps)以自包含 HTML 面板的形式直接在聊天中渲染,并带有全屏切换功能,适用于以下受支持的客户端:

  • Claude Desktop
  • 带 GitHub Copilot 的 VS Code
  • Claude Code
  • Goose

您不需要此服务器的任何其他工具即可使用它。 render_map_tool 也直接接受手工编写的 GeoJSON——您自己的多边形、标记和路线——不依赖 directions_toolisochrone_tool 或任何其他 Mapbox API 调用。请参阅 完整的 render_map_tool 指南 了解载荷模式和完整的独立示例。

如果您需要在不支持 MCP Apps 的客户端中获取有保证的静态图像,请改用 static_map_image_tool——它返回每个客户端都能显示的 base64 编码 PNG/JPEG。

CLIENT_NEEDS_RESOURCE_FALLBACK

资源回退工具(为非兼容客户端提供的可选功能)

资源是 MCP 的核心功能,大多数客户端(Claude Desktop、VS Code、MCP Inspector 等)都支持。然而,某些客户端(如 smolagents)完全不支持资源。对于这些客户端,服务器可以提供“资源回退工具”,通过工具调用提供与资源相同的内容。

回退工具:

  • resource_reader_tool - 按 URI 读取任何资源的通用回退工具
  • category_list_tool - 提供类别列表访问(mapbox://categories)

默认情况下,这些工具不包含在内(假定您的客户端支持资源)。如果您的客户端不支持资源,请启用回退工具:

export CLIENT_NEEDS_RESOURCE_FALLBACK=true

何时设置此项:

  • ✅ 如果使用 smolagents 或其他不支持资源的客户端,请设置为 true
  • ❌ 如果使用 Claude Desktop、VS Code、MCP Inspector 或任何支持资源的客户端,请保持未设置(默认)
  • ❌ 如果不确定,请保持未设置(大多数客户端支持资源)

工具

实用工具

资源读取器工具

为不支持原生 MCP 资源 API 的客户端提供 MCP 资源访问。使用此工具读取类别列表等资源。

参数

  • uri:要读取的资源 URI(例如 mapbox://categoriesmapbox://categories/ja

示例用法

  • 读取默认类别:{"uri": "mapbox://categories"}
  • 读取日文类别:{"uri": "mapbox://categories/ja"}

注意:如果您的 MCP 客户端支持原生资源,建议直接使用资源 API 以获得更好的性能。

离线地理空间工具

这些工具完全离线执行地理空间计算,无需调用 Mapbox API。它们使用 Turf.js 进行精确的地理计算,可在任何地方工作,即使没有互联网连接。

距离工具

使用 Haversine 公式计算两个地理坐标之间的距离。

功能

  • 支持多种单位:公里、英里、米、英尺、海里
  • 精确的大圆距离计算
  • 无需 API 调用

示例用法:“旧金山(37.7749°N, 122.4194°W)和纽约(40.7128°N, 74.0060°W)之间的距离是多少?”

多边形内点工具

针对一个多边形或多边形集合测试一个或多个点,仅返回位于内部的点。一次调用即可处理单个点或批量点。

功能

  • 支持包含孔洞的复杂多边形
  • 支持多多边形
  • 一次调用即可批量测试任意数量的点
  • 适用于地理围栏、配送区域验证和客户细分

示例用法:“这些配送地址中有哪些在我们的服务区域内?”

目标点工具

根据起点、方位角和距离,使用测地线(大圆)偏移计算目标点。

功能

  • 直线偏移,而非路线路径
  • 适用于“找到X以北5公里的点”或构建搜索偏移
  • 无需API调用

示例用法:“太空针塔东北方向10公里的点是哪里?”

方位角工具

计算从一个坐标到另一个坐标的罗盘方向(方位角)。

功能

  • 返回以度为单位的方向角(0-360°)
  • 提供基本方位(北、东北、东、东南、南、西南、西、西北)
  • 适用于导航和方向查询

示例用法:“从这里去机场应该朝哪个方向走?”

中点工具

沿大圆路径计算两个坐标之间的地理中点。

功能

  • 计算地球曲面上的真实中点
  • 适用于会面点建议
  • 正确处理长距离计算

示例用法:“旧金山和纽约之间的中点在哪里?”

质心工具

计算多边形或多多边形的几何中心(质心)。

功能

  • 适用于复杂形状
  • 返回所有点的算术平均值
  • 适用于放置标签或标记

示例用法:“我应该把这个街区的标记放在哪里?”

面积工具

计算多边形的面积。

功能

  • 支持多种单位:平方米、平方公里、英亩、公顷、平方英里、平方英尺
  • 在地球表面进行精确面积计算
  • 适用于任意大小的多边形

示例用法:“这个公园的面积是多少英亩?”

边界框工具

计算包含几何体的最小边界框(bbox)。

功能

  • 适用于点、线、多边形和多多边形
  • 返回 [最小经度, 最小纬度, 最大经度, 最大纬度]
  • 适用于视口计算和空间索引

示例用法:“这条路线的边界框是什么?”

缓冲区工具

在点、线或多边形周围创建缓冲区(多边形)。

功能

  • 支持多种距离单位
  • 在点周围创建圆形缓冲区
  • 适用于邻近分析和影响区域创建

示例用法:“显示该位置周围5公里的缓冲区”

简化工具

使用Douglas-Peucker算法减少线或多边形的顶点数量。

功能

  • 可配置容差以控制细节级别
  • 在降低复杂度的同时保持整体形状
  • 适用于减小文件大小和提高渲染性能
  • 可选择保持拓扑结构(防止自相交)

示例用法:“简化这个复杂边界以减少点的数量”

长度工具

测量由一系列坐标定义的线的总长度。

功能

  • 支持公里、英里、米和英尺
  • 无需路由API调用即可测量绘制的路线、路径或边界

示例用法:“这条徒步路线有多长?”

凸包工具

计算一组点的凸包——包含所有点的最小凸多边形。

功能

  • 适用于边界区域分析或覆盖范围估算
  • 无需API调用即可离线工作

示例用法:“包含所有这些门店位置的最小多边形是什么?”

最近点工具

在集合中找到距离给定目标点最近的点。

功能

  • 比逐个调用distance_tool再排序更高效
  • 适用于查找距离某位置最近的商店、站点或地标

示例用法:“这些商店中哪个离我当前位置最近?”

线上最近点工具

将点吸附到线或路线上最近的位置,返回该点及其距离。

功能

  • 适用于“这条路线上哪个点离我最近?”或无需API调用的地图匹配

示例用法:“我现在在这条徒步路线上离哪里最近?”

并集、交集和差集工具

组合或比较两个或多个多边形——union_tool将它们合并为一个几何体,intersect_tool查找它们共享的区域,difference_tool从一个中减去另一个。

功能

  • 适用于合并服务区域、查找覆盖重叠或计算排除区域(例如“区域A覆盖但区域B未覆盖的部分?”)
  • 完全离线工作——无需API调用
  • 每个都返回一个render_map_tool引用,以便直接可视化结果

示例用法:“将这两个配送区域合并为一个覆盖区域” / “这两个等时线在哪里重叠?” / “我们的15分钟等时线未覆盖这个服务区域的哪部分?”

Mapbox API 工具

类别列表工具(已弃用)

⚠️ 已弃用:请改用URI为mapbox://categoriesresource_reader_tool,或者如果您的客户端支持MCP资源,可直接访问mapbox://categories资源。

此工具仅为不支持MCP资源或resource_reader_tool的客户端提供向后兼容性而保留。

矩阵工具

使用Mapbox矩阵API计算多个点之间的旅行时间和距离。功能包括:

  • 高效的一对多、多对一或多对多路由计算
  • 支持不同的出行方式(驾车-实时交通、驾车、步行、骑行)
  • 可指定出发时间以进行交通感知计算
  • 路线摘要,包含距离和时长指标
  • 控制接近方式(路边/不受限制)和允许的出发方位角范围

静态图像工具

使用Mapbox静态图像API生成静态地图图像。功能包括:

  • 自定义地图样式(街道、户外、卫星等)
  • 可调整的图像尺寸和缩放级别
  • 支持多个标记,可自定义颜色和标签
  • 叠加选项,包括折线和多边形
  • 自动适配指定坐标

类别搜索工具

使用Mapbox搜索框类别搜索API执行类别搜索。功能包括:

  • 按类别搜索兴趣点(餐厅、酒店、加油站等)
  • 按地理邻近度过滤
  • 可自定义结果数量限制
  • 每个结果包含丰富的元数据
  • 支持多种语言

反向地理编码工具

使用Mapbox地理编码V6 API执行反向地理编码。功能包括:

  • 将地理坐标转换为人类可读的地址
  • 可自定义详细级别(街道、街区、城市等)
  • 按类型过滤结果(地址、兴趣点、街区等)
  • 支持多种语言
  • 丰富的位置上下文信息

地面位置工具

通过一次调用回答“这个坐标附近有什么”的问题——地点名称、附近的兴趣点以及旅行时间可达性——数据来自实时Mapbox数据并附带引用。请使用此工具,而不是将reverse_geocode_tool与网络搜索串联使用。

功能

  • 对查询进行分类(路由、街区上下文、兴趣点搜索或区域/可达性),仅获取相关数据
  • 按请求按类别搜索附近兴趣点
  • 旅行时间可达性摘要(基于等时线)
  • 返回一个render_map_tool引用,其中绘制了定位位置和附近兴趣点

示例用法:“这个坐标在哪个街区,附近有咖啡店吗?”

地点详情工具

使用Mapbox ID检索特定地点的详细信息——照片、营业时间、评分、电话号码和网站URL。在search_and_geocode_toolcategory_search_toolreverse_geocode_tool之后使用,以获取特定结果的更多详情。

示例用法:“告诉我更多关于第一个咖啡店结果的信息——营业时间、电话号码和网站”

路线工具

使用Mapbox路线API获取路线指引。功能包括:

  • 支持不同的路线模式:驾车(实时交通或典型)、步行和骑行
  • 多途经点路线(2-25个坐标对)
  • 备选路线选项
  • 路线注释(距离、时长、速度、拥堵情况)
  • 调度选项:
    • 未来出发时间(depart_at),适用于驾车和驾车-实时交通模式
    • 期望到达时间(arrive_by),仅适用于驾车模式
  • 特定模式的优化:
    • 驾车:车辆尺寸限制(高度、宽度、重量)
  • 路线排除选项:
    • 常见排除项:渡轮路线、仅现金收费
    • 驾车特定排除项:收费公路、高速公路、未铺装道路、隧道、国界、州界
    • 自定义点排除(最多50个要避开的点)
  • GeoJSON几何输出格式

等时线工具

使用Mapbox等时线API计算从某位置在指定时间内可到达的区域。功能包括:

  • 支持不同的出行方式(驾车、步行、骑行)
  • 可自定义旅行时间或距离
  • 多轮廓生成(例如15、30、45分钟范围)
  • 可选的出发或到达时间指定
  • 可视化颜色自定义

搜索和地理编码工具

使用Mapbox搜索框文本搜索API端点来支持搜索和地理编码兴趣点、地址、地点以及该API支持的任何其他类型。 此工具将先前由ForwardGeocodeTool和PoiSearchTool(来自此MCP服务器的早期版本)提供的功能整合为单个工具。

地图匹配工具

使用Mapbox地图匹配API将GPS轨迹吸附到道路网络。功能包括:

  • 将嘈杂的GPS轨迹转换为道路网络上的干净路线
  • 支持不同的出行方式(驾车、驾车-实时交通、步行、骑行)
  • 每次请求最多处理100个坐标对
  • 可选时间戳以根据速度提高准确性
  • 可配置的吸附半径以适应不同GPS质量级别
  • 路线注释(限速、距离、时长、交通拥堵)
  • 多种几何输出格式(GeoJSON、折线)

示例用法:“清理这条GPS轨迹并将其吸附到道路上:[带时间戳的坐标]”

优化工具

使用Mapbox优化API查找经过多个位置的最优路线。功能包括:

  • 解决2-12个位置的旅行商问题(TSP)
  • 支持不同的出行方式(驾车、驾车-实时交通、步行、骑行)
  • 灵活的起点和终点配置
  • 往返或单程路线优化
  • 逐向导航指令(可选)
  • 路线注释(距离、时长、速度)
  • 多种几何输出格式(GeoJSON、折线)

示例用法:“找到访问这5个站点的最优路线:[地址或坐标列表]”

注意:具有高级功能(时间窗口、容量限制、多车辆)的V2 API可用,但需要测试版访问权限。V2实现包含在代码库中,但默认未注册。

开发

检查服务器

使用Node.js

# Run the built image
npm run inspect:build

使用Docker

# Build the Docker image
docker build -t mapbox-mcp-server .

# Run and inspect the server
npx @modelcontextprotocol/inspector docker run -i --rm --env MAPBOX_ACCESS_TOKEN="YOUR_TOKEN" mapbox-mcp-server

创建新工具

npx plop create-tool
# provide tool name without suffix (e.g. Search)

发布新版本

# 1. Bump version in package.json
npm version <new-version> --no-git-tag-version

# 2. Sync version to manifest.json and server.json
npm run sync-manifest

# 3. Prepare CHANGELOG (replaces "Unreleased" with version and date)
npm run changelog:prepare-release <new-version>

# 4. Update package-lock.json
npm install

# 5. Review changes, then commit and tag
git add package.json package-lock.json manifest.json server.json CHANGELOG.md
git commit -m "Release v<new-version>"
git tag v<new-version>
git push && git push --tags

重要:发布者工作流会验证package.jsonserver.json版本是否与发布版本匹配。跳过版本升级或清单同步将导致发布失败。

OpenTelemetry追踪

此MCP服务器包含全面的OpenTelemetry追踪,用于生产可观测性:

快速演示

# 1. Copy the example configuration
cp .env.example .env

# 2. Edit .env to add your MAPBOX_ACCESS_TOKEN and configure tracing

# 3. Start Jaeger for local development
npm run tracing:jaeger:start

# 4. Run the server (it will automatically use .env configuration)
npm run inspect:build

# 5. View traces at http://localhost:16686

# 6. Stop Jaeger when done
npm run tracing:jaeger:stop

注意: 服务器会在启动时自动从你的 .env 文件加载配置。.env.example 文件包含多个可观测性平台的配置示例。

支持的可观测性平台

.env.example 中包含以下平台的配置示例:

云服务提供商:

  • ☁️ AWS X-Ray
  • ☁️ Azure Monitor(Application Insights)
  • ☁️ Google Cloud Trace

SaaS 平台:

  • 📊 Datadog
  • 📊 New Relic
  • 📊 Honeycomb
  • 📊 任何兼容 OTLP 的后端

生产环境配置

完整的设置说明请参阅 docs/tracing.md,包括:

  • 🔧 平台专属配置指南
  • 📊 认证与端点设置
  • 🎯 自定义追踪属性和上下文
  • 🚀 性能优化(最小开销)
  • 🔍 故障排除与调试

追踪功能:

  • ✅ 配置加载追踪(.env 文件加载)
  • ✅ 自动工具执行追踪
  • ✅ 带 CloudFront 关联 ID 的 HTTP 请求检测
  • ✅ 可配置的导出器(控制台、OTLP)
  • ✅ 注重安全性(数据保护、JWT 验证)
  • ✅ 生产就绪(CPU 开销低于 1%)

贡献指南

我们欢迎您为 Mapbox MCP 服务器做出贡献!在提交拉取请求之前,请阅读 CONTRIBUTING.md

完整的标准与指南:

贡献者快速入门

  1. Fork 仓库并克隆你的分支
  2. 安装依赖:npm install
  3. 按照我们的编码标准进行修改
  4. 运行测试和代码检查:npm test && npm run lint
  5. 为新功能添加测试
  6. 提交带有清晰描述的拉取请求

所有贡献必须通过我们的 CI 检查和代码审查流程。详细要求请参阅 docs/engineering_standards.md

数据使用与隐私

发送到 Mapbox API 的数据

当你使用 MCP 服务器工具时,以下数据会直接从你的环境发送到 Mapbox API:

  • 地理编码工具:地址/位置文本、坐标、国家/地区筛选条件
  • 搜索工具:搜索查询、用于邻近搜索的位置坐标、类别筛选条件
  • 路线规划工具:起点/终点坐标、途经点、路线偏好、车辆限制
  • 矩阵工具:多组坐标对、出行方式、出发时间
  • 静态地图工具:坐标、缩放级别、样式偏好、标记信息
  • 等时线工具:起点坐标、时间/距离参数、出行方式

你的隐私

  • 本地执行:所有 API 调用均直接从你的环境发送到 Mapbox API
  • 令牌安全:你的 Mapbox API 令牌保留在本地机器上,绝不会传输给此 MCP 服务器或由其存储
  • 不存储数据:此 MCP 服务器不会存储、记录或收集你的任何数据或 API 请求
  • 直接通信:你和 Mapbox API 之间不存在中间服务器

第三方数据使用

  • Mapbox 的隐私政策 适用于发送到其 API 的数据:https://www.mapbox.com/legal/privacy/
  • API 使用:通过这些工具发出的所有请求均适用标准 Mapbox API 条款
  • 数据保留:有关数据保留政策,请参阅 Mapbox 的文档

支持与联系

关于 MCP 服务器问题

关于 Mapbox API 问题

维护承诺

此 MCP 服务器由 Mapbox, Inc. 官方维护。我们提供:

  • 针对新 Mapbox API 功能的定期更新
  • 错误修复和安全更新
  • 与最新 MCP 协议版本的兼容性
  • 通过 GitHub Issues 提供社区支持

MIT 许可证