mcp/mapbox-devkit
为AI助手提供直接访问Mapbox开发者API的能力，支持样式管理、令牌管理、GeoJSON预览及其他开发工具，助力构建Mapbox应用。
Mapbox Developer MCP Server
为AI助手提供直接访问Mapbox开发者API的能力，支持样式管理、令牌管理、GeoJSON预览及其他开发工具，用于构建Mapbox应用。
什么是MCP Server？
MCP信息
| 属性 | 详情 |
|---|---|
| Docker镜像 | https://hub.docker.com/repository/docker/mcp/mapbox-devkit |
| 作者 | https://github.com/mapbox |
| 代码仓库 | https://github.com/mapbox/mcp-devkit-server |
镜像构建信息
| 属性 | 详情 |
|---|---|
| Dockerfile | https://github.com/mapbox/mcp-devkit-server/blob/8984c4f22c4d7b60447c1cc71d47cccc63f677d6/Dockerfile |
| 提交 | 8984c4f22c4d7b60447c1cc71d47cccc63f677d6 |
| Docker镜像构建者 | Docker Inc. |
| Docker Scout健康评分 | !Docker Scout Health Score |
| 验证签名 | COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/mapbox-devkit --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub |
| 许可证 | MIT License |
可用工具（23个）
| 工具名称 | 简短描述 |
|---|---|
bounding_box_tool | 计算GeoJSON边界框工具 |
check_color_contrast_tool | 检查颜色对比度工具 |
compare_styles_tool | 比较样式工具 |
coordinate_conversion_tool | 坐标转换工具 |
country_bounding_box_tool | 获取国家边界框工具 |
create_style_tool | 创建Mapbox样式工具 |
create_token_tool | 创建Mapbox令牌工具 |
delete_style_tool | 删除Mapbox样式工具 |
geojson_preview_tool | 预览GeoJSON数据工具 |
get_feedback_tool | 获取反馈工具 |
list_feedback_tool | 列出反馈工具 |
list_styles_tool | 列出Mapbox样式工具 |
list_tokens_tool | 列出Mapbox令牌工具 |
optimize_style_tool | 优化样式工具 |
preview_style_tool | 预览Mapbox样式工具 |
retrieve_style_tool | 获取Mapbox样式工具 |
style_builder_tool | 构建Mapbox样式JSON工具 |
style_comparison_tool | 比较Mapbox样式工具 |
tilequery_tool | Mapbox瓦片查询工具 |
update_style_tool | 更新Mapbox样式工具 |
validate_expression_tool | 验证表达式工具 |
validate_geojson_tool | 验证GeoJSON工具 |
validate_style_tool | 验证样式工具 |
工具详情
工具：bounding_box_tool
计算给定GeoJSON内容的边界框，返回格式为[minX, minY, maxX, maxY]
| 参数 | 类型 | 描述 |
|---|---|---|
geojson | string | 用于计算边界框的GeoJSON内容 |
此工具为只读工具，不修改环境。
工具：check_color_contrast_tool
检查前景色和背景色之间的颜色对比度，以符合WCAG 2.1无障碍标准
| 参数 | 类型 | 描述 |
|---|---|---|
backgroundColor | string | 背景颜色，支持任何CSS格式（十六进制、rgb、rgba、命名颜色） |
foregroundColor | string | 前景颜色（文本颜色），支持任何CSS格式（十六进制、rgb、rgba、命名颜色） |
fontSize | string 可选 | 字体大小类别：normal（<18pt或<14pt粗体）或large（≥18pt或≥14pt粗体） |
level | string 可选 | 要检查的WCAG合规级别（默认：AA） |
此工具为只读工具，不修改环境。
工具：compare_styles_tool
比较两个Mapbox样式，报告结构、图层、数据源和属性的差异
| 参数 | 类型 | 描述 |
|---|---|---|
styleA | string | 第一个Mapbox样式（JSON字符串或样式对象） |
styleB | string | 第二个Mapbox样式（JSON字符串或样式对象） |
ignoreMetadata | boolean 可选 | 是否忽略元数据字段（如id、owner、created、modified） |
此工具为只读工具，不修改环境。
工具：coordinate_conversion_tool
在WGS84（经度/纬度）和EPSG:3857（Web墨卡托）坐标系统之间转换坐标
| 参数 | 类型 | 描述 |
|---|---|---|
coordinates | array | 表示坐标的两个数字组成的数组 |
from | string | 源坐标系统：wgs84（经度/纬度）或epsg3857（Web墨卡托） |
to | string | 目标坐标系统：wgs84（经度/纬度）或epsg3857（Web墨卡托） |
此工具为只读工具，不修改环境。
工具：country_bounding_box_tool
通过ISO 3166-1国家代码获取国家边界框，返回格式为[minX, minY, maxX, maxY]
| 参数 | 类型 | 描述 |
|---|---|---|
iso_3166_1 | string | ISO 3166-1国家代码（2-10个字符，例如："CN"、"US"、"AE"） |
此工具为只读工具，不修改环境。
工具：create_style_tool
创建新的Mapbox样式
| 参数 | 类型 | 描述 |
|---|---|---|
name | string | 样式的人类可读名称 |
style | object | 完整的Mapbox样式规范对象。必须包含：version（8）、sources、layers。可选：sprite、glyphs、center、zoom、bearing、pitch、metadata等。详见[***] |
此工具与外部实体交互。
工具：create_token_tool
创建具有指定范围和可选URL限制的新Mapbox公共访问令牌
| 参数 | 类型 | 描述 |
|---|---|---|
note | string | 令牌描述 |
scopes | array | 公共令牌的权限范围数组。有效范围：styles:tiles、styles:read、fonts:read、datasets:read、vision:read |
allowedUrls | array 可选 | 令牌可使用的URL数组（最多100个） |
expires | string 可选 | 可选的过期时间（ISO 8601格式，最长为未来1小时） |
此工具与外部实体交互。
工具：delete_style_tool
通过ID删除Mapbox样式
| 参数 | 类型 | 描述 |
|---|---|---|
styleId | string | 要删除的样式ID |
此工具可能执行破坏性更新。
此工具具有幂等性，使用相同参数重复调用不会产生额外效果。
此工具与外部实体交互。
工具：geojson_preview_tool
生成geojson.io/next URL以可视化GeoJSON数据，仅返回URL链接
| 参数 | 类型 | 描述 |
|---|---|---|
geojson | string | GeoJSON数据（JSON字符串，例如：{"type": "Point", "coordinates": [-122.4194, 37.7749]}） |
此工具为只读工具，不修改环境。
工具：get_feedback_tool
通过唯一ID从Mapbox Feedback API获取单个用户反馈项。用于检索用户报告的地图数据、路由或POI详情相关问题、建议或反馈的详细信息。访问令牌需要user-feedback:read权限。
| 参数 | 类型 | 描述 |
|---|---|---|
feedback_id | string | 反馈项的唯一标识符 |
format | string 可选 | 输出格式："json_string"返回可解析的原始JSON数据字符串；"formatted_text"返回人类可读文本。两者均返回文本内容，但json_string包含可解析的JSON数据，而formatted_text用于显示 |
此工具为只读工具，不修改环境。
此工具与外部实体交互。
工具：list_feedback_tool
从Mapbox Feedback API列出用户反馈项，支持过滤、排序和分页。用于访问用户报告的地图数据、路由和POI详情相关问题、建议和反馈。支持按状态、类别、日期范围、跟踪ID和搜索文本进行全面过滤。访问令牌需要user-feedback:read权限。
| 参数 | 类型 | 描述 |
|---|---|---|
after | string 可选 | 来自先前响应的游标，用于获取下一页结果 |
category | array 可选 | 按一个或多个反馈类别过滤 |
created_after | string 可选 | 返回在此时间之后创建的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
created_before | string 可选 | 返回在此时间之前创建的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
feedback_ids | array 可选 | 按一个或多个反馈项ID过滤，至少匹配一个 |
format | string 可选 | 输出格式："json_string"返回可解析的原始JSON数据字符串；"formatted_text"返回人类可读文本。两者均返回文本内容，但json_string包含可解析的JSON数据，而formatted_text用于显示 |
limit | number 可选 | 返回的最大反馈项数量（1-1000） |
order | string 可选 | 排序方向：asc（升序，默认）或desc（降序） |
received_after | string 可选 | 返回Mapbox在此时间之后收到的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
received_before | string 可选 | 返回Mapbox在此时间之前收到的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
search | string 可选 | 搜索短语，返回反馈文本包含该短语的项 |
sort_by | string 可选 | 排序字段：received_at（默认）、created_at或updated_at |
status | array 可选 | 按一个或多个反馈状态过滤，选项：received、fixed、reviewed、out_of_scope |
trace_id | array 可选 | 按一个或多个trace_id值过滤，至少匹配一个 |
updated_after | string 可选 | 返回最后更新时间在此之后的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
updated_before | string 可选 | 返回最后更新时间在此之前的项，使用ISO 8601格式：YYYY-MM-DDTHH:mm:ss.SSSZ |
此工具为只读工具，不修改环境。
此工具与外部实体交互。
工具：list_styles_tool
列出Mapbox账户的样式。使用limit参数避免大型响应（推荐：limit=5-10）。使用start参数进行分页。
| 参数 | 类型 | 描述 |
|---|---|---|
limit | number 可选 | 返回的最大样式数量（推荐：5-10以避免令牌限制，默认：无限制） |
start | string 可选 | 分页起始令牌（使用先前响应中的"start"值） |
此工具为只读工具，不修改环境。
此工具与外部实体交互。
工具：list_tokens_tool
列出经过身份验证的用户的Mapbox访问令牌，支持可选过滤和分页。返回所有令牌（公共和秘密）的元数据，但实际令牌值仅包含在公共令牌中（出于安全考虑，秘密令牌值被省略）。使用分页时，"start"参数必须从先前响应的"next_start"字段获取（它不是令牌ID）
| 参数 | 类型 | 描述 |
|---|---|---|
default | boolean 可选 | 仅显示默认公共令牌 |
limit | number 可选 | 返回的最大令牌数量（1-100） |
sortby | string 可选 | 按创建或修改时间戳排序令牌 |
start | string 可选 | 分页起始令牌ID |
usage | string 可选 | 按令牌类型过滤：pk（公共） |
此工具为只读工具，不修改环境。
此工具与外部实体交互。
工具：optimize_style_tool
通过删除未使用的数据源、重复图层和简化表达式来优化Mapbox样式
| 参数 | 类型 | 描述 |
|---|---|---|
style | string | 要优化的Mapbox样式（JSON字符串或样式对象） |
optimizations | array 可选 | 要应用的特定优化（如果未指定，则应用所有优化） |
此工具为只读工具，不修改环境。
工具：preview_style_tool
使用现有公共令牌生成Mapbox样式的预览URL
| 参数 | 类型 | 描述 |
|---|---|---|
accessToken | string | Mapbox公共访问令牌（必需，必须以pk.开头并具有styles:read权限）。秘密令牌（sk.）不能使用，因为它们不能在浏览器URL中公开。请使用现有公共令牌或通过list_tokens_tool获取，或使用create_token_tool创建具有styles:read权限的令牌 |
styleId | string | 要预览的样式ID |
title | boolean 可选 | 在预览中显示标题 |
zoomwheel | boolean 可选 | 启用缩放 wheel 控制 |
此工具为只读工具，不修改环境。
工具：retrieve_style_tool
通过ID检索特定的Mapbox样式
| 参数 | 类型 | 描述 |
|---|---|---|
styleId | string | 要检索的样式ID |
此工具为只读工具，不修改环境。
此工具与外部实体交互。
工具：style_builder_tool
生成Mapbox样式JSON，用于创建新样式或更新现有样式。
该工具使用Streets v8数据智能解析图层类型和过滤属性。无需确切的图层名称——工具会根据过滤器自动找到正确的图层。
基础样式： • standard：始终为默认值——现代Mapbox Standard，性能最佳 • 经典样式：streets-v12/light-v11/dark-v11/satellite-v9/outdoors-v12/satellite-streets-v12/navigation-day-v1/navigation-night-v1 仅当用户明确要求"创建经典样式"或使用现有经典样式时才使用经典样式
标准样式配置： 使用standard_config自定义底图： • 主题：default/faded/monochrome • 光线：day/night/dawn/dusk • 显示/隐藏：标签、道路、3D建筑物 • 颜色：水域、道路、公园等
图层顺序： • 图层按顺序渲染——数组中的最后一个图层在视觉上显示在最上方 • 'slot'参数为可选——默认情况下，数组中的图层顺序决定可见性 • 对于标准样式，可选择使用'slot'控制位置：
- 无slot（默认）：在样式中所有现有图层之上
- 'top'：在地点和交通标签之后
mcp/mapbox
mcp（Model Context Protocol）
通过Mapbox API将任何AI代理转换为地理空间感知系统，提供地理编码、POI搜索、路由规划、行程时间矩阵、等时线和静态地图生成功能。
2 次收藏5.5千+ 次下载
6 天前更新
devkitpro/devkitarm
devkitpro
为GBA、DS、3DS、GP32、GP2X掌上游戏机提供的集成开发环境，支持相关平台的应用程序开发与编译。
25 次收藏10万+ 次下载
1 个月前更新
devkitpro/devkita64
devkitpro
Switch development environment.
22 次收藏10万+ 次下载
1 个月前更新
devkitpro/devkitppc
devkitpro
用于Cube、Wii及WiiU平台的开发环境Docker镜像，提供一站式开发工具和环境配置，简化相关平台应用程序的开发流程。
14 次收藏10万+ 次下载
1 个月前更新
mapboxgeodata/base-spark-2.4.3
mapboxgeodata
暂无描述
10万+ 次下载
1 年前更新
mapboxgeodata/base-spark-2.4.0
mapboxgeodata
暂无描述
10万+ 次下载
1 年前更新
轩辕镜像配置手册
探索更多轩辕镜像的使用方法，找到最适合您系统的配置方式
Docker 配置
登录仓库拉取
通过 Docker 登录认证访问私有仓库
专属域名拉取
无需登录使用专属域名
K8s Containerd
Kubernetes 集群配置 Containerd
K3s
K3s 轻量级 Kubernetes 镜像加速
Dev Containers
VS Code Dev Containers 配置
Podman
Podman 容器引擎配置
Singularity/Apptainer
HPC 科学计算容器配置
其他仓库配置
ghcr、Quay、nvcr 等镜像仓库
Harbor 镜像源配置
Harbor Proxy Repository 对接专属域名
Portainer 镜像源配置
Portainer Registries 加速拉取
Nexus 镜像源配置
Nexus3 Docker Proxy 内网缓存
系统配置
需要其他帮助？请查看我们的 常见问题Docker 镜像访问常见问题解答 或 提交工单
镜像拉取常见问题
使用与功能问题
错误码与失败问题
docker pull 提示 manifest unknown 怎么办？
manifest unknown
docker pull 提示 no matching manifest 怎么办？
no matching manifest（架构）
镜像已拉取完成，却提示 invalid tar header 或 failed to register layer 怎么办？
invalid tar header（解压）
Docker pull 时 HTTPS / TLS 证书验证失败怎么办？
TLS 证书失败
Docker pull 时 DNS 解析超时或连不上仓库怎么办？
DNS 超时
Docker 拉取出现 410 Gone 怎么办？
410 Gone 排查
出现 402 或「流量用尽」提示怎么办？
402 与流量用尽
Docker 拉取提示 UNAUTHORIZED（401）怎么办？
401 认证失败
遇到 429 Too Many Requests（请求太频繁）怎么办？
429 限流
docker login 提示 Cannot autolaunch D-Bus，还算登录成功吗？
D-Bus 凭证提示
为什么会出现「单层超过 20GB」或 413，无法加速拉取？
413 与超大单层
账号 / 计费 / 权限
用户好评
来自真实用户的反馈，见证轩辕镜像的优质服务
oldzhang
运维工程师
Linux服务器
5
"Docker访问体验非常流畅，大镜像也能快速完成下载。"