Mapbox MCP Server

官方

把 Mapbox 的地理数据与路线能力接入你的 AI 助手

分类: 其他第 8 / 230
Stars: ★ 361 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · 远程托管（无需本地环境）
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 天前
工具数: 31

71FMRS · B

Mapbox MCP Server 由 Mapbox 官方维护，将地理编码、POI 搜索、路线规划、等时圈、地图渲染及大量离线几何计算工具整合进一个 MCP 服务，功能覆盖全面，但强依赖 Mapbox 访问令牌与网络连接，敏感位置数据会发送至 Mapbox API。

最强项 · 文档质量 17/20 最弱项 · 可靠性 11/20

可靠性

11/20

安全与权限

14/20

维护活跃度

16/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 11/20: manifest 声明了 stdio (npx) 和远程 streamable-http 两种传输方式，README 中工具列表（地理编码、路线、等时圈、离线几何计算等）描述详尽且与 manifest 描述一致，未见明显自相矛盾之处。但本次评审仅基于 README 与 manifest 静态材料，未见任何 CI 工作流文件或测试文件作为可验证证据；CONTRIBUTING 中提到的 `npm test`/`npm run lint` 仅为流程声明，无法核实其真实覆盖率或是否通过。根据静态评审规则，在缺乏可验证的执行证据时可靠性上限为 12 分，故给出 11 分：happy path 描述可信，但边界情况、错误处理、依赖控制均未在提供材料中得到验证。
安全与权限 14/20: 凭证处理方面披露较为清晰：MAPBOX_ACCESS_TOKEN 被标记为 required+secret，README『Data Usage & Privacy』章节明确说明 token 仅保留在本地环境、服务器不存储/不记录用户数据，且列出了各工具发送给 Mapbox API 的具体数据字段，体现了较好的数据边界透明度。所有工具均为只读地理计算或查询类操作（geocoding、routing、isochrone、离线 turf.js 计算等），未见删除、支付、远程执行等不可逆高危默认行为，不触及红线。但也存在缺口：manifest 中同时声明了官方托管的远程端点 `https://mcp.mapbox.com/mcp`，而其鉴权方式（是否复用同一 token、如何传输）未在材料中说明，构成信任边界的不确定性；此外 `render_map_tool` 通过 MCP Apps 协议渲染自定义 HTML/GeoJSON 面板，具体沙箱与权限隔离机制未详细披露。因此不构成红线问题，但权限/确认机制说明不完整，给 14 分。
维护活跃度 16/20: 仓库为 Mapbox 官方维护，MIT 许可证明确，manifest 版本号 0.14.0，README 提供了完整的发布流程（版本号同步、CHANGELOG 更新、tag 推送）与 CI 版本一致性校验说明，体现出规范的版本治理。README 明确写明『Maintenance Commitment』，承诺持续更新、修复 bug、跟进 MCP 协议版本，并提供邮箱与 GitHub Issues 两个支持渠道；仓库未被归档，350 星、仅 4 个未关闭 issue，暗示问题响应较及时（但这只是人气/活跃度的间接信号，未据此加分）。由于未能看到实际的 commit 时间线或近期发布日期以核实『持续』的真实性，故未给满分，给 16 分。
文档质量 17/20: 文档层次丰富：主 README 详述每个工具的功能、参数、使用示例，并链接到多个客户端集成指南（Claude Desktop、VS Code、Cursor、Goose、Smolagents）、resources/elicitations/tracing/render_map_tool 等专项文档，以及一个明确的数据使用与隐私章节。示例 prompt 覆盖面广，涵盖地点发现、导航、可视化、离线几何计算等类别，且对已废弃工具（category_list_tool）做了明确标注和替代方案说明。不足之处在于未在提供材料中给出具体的 API 费用/速率限制细节（仅链接到 Mapbox 官方文档），故不满分，给 17 分。
安装易用性 13/20: 提供两种接入方式：直接使用官方托管端点（无需本地安装）或通过 `npx @mapbox/mcp-server` 本地运行并设置 `MAPBOX_ACCESS_TOKEN` 环境变量，且有获取 token 的清晰步骤链接。README 还链接了多个具体客户端的配置指南文档。但根据静态评审规则，在没有可验证的 CI/测试证据支撑『可复现』结论时，setup 分数上限为 15；同时本次提供的 README 片段未直接给出可复制粘贴的 JSON 客户端配置示例（仅通过外部文档链接说明），配置步骤分散在多个文档中，略增加了操作复杂度，故给 13 分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么执行命令或代码访问网络

适合谁

需要地理编码、POI 搜索、路线规划等真实地图数据的 AI 应用开发者
物流、出行、地产选址等需要离线几何计算(面积、缓冲区、并交差集)的场景
使用 Claude Desktop、VS Code Copilot、Claude Code 或 Goose 等支持 MCP Apps 的客户端，希望获得可视化地图展示的用户

不适合谁

没有 Mapbox 账号或不愿申请访问令牌的用户
需要完全离线、不依赖任何外部 API 的地理编码/路线场景(仅部分几何计算工具支持离线)
需要车队级多车辆、时间窗和容量约束优化的场景(V2 优化 API 需 beta 权限，默认未注册)

所需权限

需要一个有效的 Mapbox 访问令牌(MAPBOX_ACCESS_TOKEN)，以环境变量形式提供，标记为敏感信息
本地 stdio 方式下需要网络访问权限以调用 Mapbox 各类 API
使用官方托管端点时需要网络访问 https://mcp.mapbox.com/mcp

风险与副作用

Mapbox 访问令牌一旦泄露可能被滥用，产生额外 API 调用费用或超出配额
地理编码、搜索、路线等工具会把地址、坐标、路线偏好等位置数据发送给 Mapbox API，需符合 Mapbox 隐私政策
render_map_tool 依赖客户端支持 MCP Apps 协议渲染 HTML 面板，若客户端不受信任的富内容处理存在缺陷可能带来风险
V2 优化等高级功能虽在代码中但默认未注册，误启用需额外 beta 权限

安装接入

准备工作

运行环境：Node.js · 远程托管（无需本地环境）

MAPBOX_ACCESS_TOKEN 必填密钥 Mapbox 访问令牌，必需。在 mapbox.com 注册免费账号后，于 account.mapbox.com 账户页面创建或使用默认公共令牌。

其他可选配置项（1 个）

CLIENT_NEEDS_RESOURCE_FALLBACK 可选可选。当客户端（如 smolagents）不支持 MCP 资源时设为 true，以启用 resource_reader_tool 和 category_list_tool 回退工具；默认不设置。

在 mapbox.com/signup 注册 Mapbox 账号，在账号页面创建或使用默认的访问令牌。
若使用本地方式，在 MCP 客户端配置中添加通过 npx 启动的 @mapbox/mcp-server，并设置环境变量 MAPBOX_ACCESS_TOKEN。
若不想本地运行，可直接将客户端指向官方托管端点 https://mcp.mapbox.com/mcp(streamable-http)。
若客户端不支持 MCP 资源(如 smolagents)，设置 CLIENT_NEEDS_RESOURCE_FALLBACK=true 以启用资源兜底工具。
重启客户端并测试地理编码或路线查询确认连接成功。

claude_desktop_config.json

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

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mapbox": {
      "command": "npx",
      "args": [
        "-y",
        "@mapbox/mcp-server"
      ],
      "env": {
        "MAPBOX_ACCESS_TOKEN": "YOUR_MAPBOX_ACCESS_TOKEN"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mapbox -e MAPBOX_ACCESS_TOKEN=YOUR_MAPBOX_ACCESS_TOKEN -- npx -y @mapbox/mcp-server

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

配置好客户端后，询问“旧金山（37.7749, -122.4194）和纽约（40.7128, -74.0060）之间的距离是多少？”——返回具体数值即证明连接成功，同时客户端工具列表中应出现 directions_tool 等 Mapbox API 工具（离线地理空间工具无需令牌即可使用）。

常见排障

确认已正确设置 MAPBOX_ACCESS_TOKEN 且令牌未过期、具备所需 API 权限范围
若工具调用失败，检查网络是否可访问 api.mapbox.com 或 mcp.mapbox.com
客户端若不支持 MCP 资源(如部分早期或第三方客户端)，设置 CLIENT_NEEDS_RESOURCE_FALLBACK=true 启用 resource_reader_tool 等兜底工具
若地图渲染未显示，确认客户端支持 MCP Apps(如 Claude Desktop、VS Code Copilot、Claude Code、Goose)，否则改用 static_map_image_tool 获取静态图片
版本升级或功能异常时，检查 package.json、manifest.json 与 server.json 中的版本号是否一致

试试这样问

连接成功后，可以直接对 AI 助手这样说：

查找帝国大厦步行距离内的咖啡店
获取从洛杉矶国际机场到好莱坞的驾车路线，并包含实时路况
显示从波特兰市中心驾车30分钟内可到达的区域
优化以下8个地址的配送路线：1600 Pennsylvania Ave、350 5th Ave、1 Infinite Loop、2300 Truxtun Rd、4150 Tempest St、600 B St、275 5th Ave、501 W Broadway

工具能力 31

resource_reader_tool 只读

为不支持原生 MCP 资源的客户端提供读取资源(如分类列表)的兜底工具。

category_list_tool 只读

(已弃用)提供搜索分类 ID 列表，建议改用 resource_reader_tool 或原生资源接口。

distance_tool 只读

使用 Haversine 公式离线计算两个坐标之间的大圆距离，支持多种单位。

points_within_polygon_tool 只读

判断一个或一批点是否位于给定多边形/复合多边形内部，适用于地理围栏和配送范围校验。

destination_tool 只读

根据起点、方位角和距离，用大圆偏移离线计算目标点坐标。

bearing_tool 只读

计算两个坐标之间的罗盘方位角(0-360°)及对应的方向。

midpoint_tool 只读

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

centroid_tool 只读

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

展开其余 23 个工具

area_tool 只读

计算多边形面积，支持平方米、平方公里、英亩等多种单位。

bounding_box_tool 只读

计算点、线、面或复合几何的最小外接矩形范围。

buffer_tool 只读

围绕点、线或面生成指定距离的缓冲区多边形。

simplify_tool 只读

使用 Douglas-Peucker 算法减少线或面的顶点数量以简化几何。

length_tool 只读

测量由一系列坐标组成的线的总长度。

convex_tool 只读

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

nearest_point_tool 只读

在一组候选点中找到距离目标点最近的点。

nearest_point_on_line_tool 只读

将目标点吸附到线或路线上最近的位置，并返回距离。

union_tool 只读

将多个多边形合并为一个几何图形。

intersect_tool 只读

计算多个多边形的重叠(相交)区域。

difference_tool 只读

从一个多边形中减去另一个多边形，得到差集区域。

matrix_tool 只读

调用 Mapbox Matrix API 计算多个地点之间的行程时间和距离矩阵，支持多种出行方式和出发时间设置。

static_map_image_tool 只读

调用 Mapbox 静态地图 API 生成带标记、路线和多边形叠加的静态地图图片(PNG/JPEG)。

category_search_tool 只读

调用 Mapbox Search Box 分类搜索 API，按类别(餐厅、酒店、加油站等)搜索兴趣点。

reverse_geocode_tool 只读

调用 Mapbox 地理编码 V6 API，将坐标转换为可读地址及位置上下文信息。

ground_location_tool 只读

针对某个坐标一次性回答“附近有什么”，综合逆地理编码、分类搜索和等时圈，返回带引用来源的结果。

place_details_tool 只读

根据 Mapbox ID 获取地点的详细信息，包括照片、营业时间、评分、电话和网站。

directions_tool 只读

调用 Mapbox Directions API 获取驾车、步行、骑行的路线规划，支持多途经点、实时路况和排除条件。

isochrone_tool 只读

调用 Mapbox Isochrone API 计算在指定时间或距离内可达的区域范围。

search_and_geocode_tool 只读

调用 Mapbox Search Box 文本搜索 API，用于搜索并地理编码兴趣点、地址和地点。

map_matching_tool 只读

调用 Mapbox Map Matching API 将带噪声的 GPS 轨迹吸附到实际路网上。

optimization_tool 只读

调用 Mapbox Optimization API 求解多地点最优访问顺序(旅行商问题)。

render_map_tool 只读

通过 MCP Apps 协议在聊天界面内渲染可交互的 Mapbox GL JS 地图，可展示路线、搜索结果或自定义 GeoJSON。

使用场景

构建具备地理位置理解能力的 AI 出行助手或位置推荐应用

在物流场景中做行程时间矩阵分析和多点配送路线优化

清洗 GPS 轨迹并吸附到路网，生成可视化路线

分析特定时间/距离内的可达区域(等时圈)用于选址或覆盖范围评估

在聊天中直接渲染交互式地图或静态地图图片展示路线与地点

支持客户端

Claude Desktop

Claude Code

GitHub Copilot

Goose

Cursor部分支持

Smolagents部分支持

依据项目文档列出，未经本站实测。

详细介绍

Mapbox MCP Server 是由 Mapbox 官方维护的 Node.js 服务器，通过 Model Context Protocol 把地理编码、兴趣点(POI)搜索、多种出行方式的路线规划、行程时间矩阵、路线优化(旅行商问题)、GPS 轨迹匹配、等时圈(isochrone)分析、静态/交互式地图渲染，以及基于 Turf.js 的离线几何计算(距离、面积、方位角、缓冲区、并集/交集/差集等)整合到一个 MCP 服务中。既可通过 npm 包以本地 stdio 方式运行，也可直接使用 Mapbox 官方托管的 streamable-http 端点，两种方式都需要提供 Mapbox 访问令牌。