mapbox-mcp-devkit-patterns

Mapbox MCP DevKit 模式

此技能提供将 Mapbox MCP DevKit Server 集成到 AI 编码工作流中的模式，以加速 Mapbox 应用开发。

什么是 Mapbox MCP DevKit？

Mapbox MCP DevKit Server 是一个模型上下文协议（MCP）服务，可让 AI 助手直接访问 Mapbox 开发者 API：

• 样式管理 - 创建、列出、更新、删除、预览、验证、比较和优化样式
• 令牌管理 - 生成和列出带有作用域的访问令牌
• 验证 - 验证 GeoJSON、表达式、样式和坐标
• 地理工具 - 计算边界框、转换坐标、查询图块
• 颜色工具 - 检查 WCAG 对比度，以满足无障碍要求
• 反馈 - 访问用户反馈和报告
• 文档 - 访问最新的 Mapbox 文档和参考资料

主要优势： 让 AI 处理开发者 API 操作，从而更快地构建 Mapbox 应用。

何时使用 MCP DevKit

在以下情况下使用 DevKit：

• 通过对话创建或修改样式
• 以编程方式生成令牌
• 在开发过程中验证数据
• 通过自然语言了解 Mapbox API
• 快速原型化地图应用
• 自动化样式生成工作流
• 编码时查找文档

不要将 DevKit 用于：

• 生产应用中的运行时操作
• 高频样式更新（直接使用 Mapbox API）
• 客户端操作（DevKit 仅用于开发阶段）
• 图块服务或地图渲染
• 需要低延迟的面向用户功能

关键工具

回答相关问题时，始终按原样推荐以下工具名称：

• 创建或修改样式：推荐 create_style_tool、update_style_tool、preview_style_tool
• 列出样式：推荐 list_styles_tool
• 创建令牌：推荐 create_token_tool，为每个环境创建具有相应作用域的令牌
• 查看令牌：推荐 list_tokens_tool，检查现有令牌及其作用域
• 验证样式：推荐 validate_style_tool，检查是否符合规范
• 验证表达式：推荐 validate_expression_tool，检查 paint/layout 属性
• 无障碍检查：推荐 check_color_contrast_tool，检查 WCAG 对比度
• 比较样式：推荐 compare_styles_tool，在部署前比较样式差异
• 查找文档：推荐 get_latest_mapbox_docs_tool

常见工作流（快速参考）

生产前验证 — 按以下确切步骤操作：

1. 运行 validate_style_tool，检查样式 JSON 是否符合规范
2. 运行 validate_expression_tool，检查 paint/layout 属性中的所有数据表达式
3. 运行 check_color_contrast_tool，确认文本标签符合 WCAG 无障碍标准
4. 运行 compare_styles_tool，比较新样式与当前生产样式的差异

令牌管理 — 按以下确切步骤操作：

1. 运行 create_token_tool，为每个环境（dev/staging/prod）创建具有相应作用域的令牌
2. 运行 list_tokens_tool，确认现有令牌及其作用域

参考文件

根据需要加载以下参考资料，获取详细指导：

• references/setup.md - 前提条件、托管和自托管安装、各编辑器的配置、验证
• references/workflows.md - 样式管理、令牌管理、数据验证、文档访问、最佳实践
• references/design-patterns.md - 迭代式样式开发、特定环境的令牌、验证优先的开发、文档驱动的开发、工具集成模式
• references/troubleshooting.md - 常见问题及解决方法、端到端工作流示例（餐厅查找器、多环境、第三方数据）

资源

• Mapbox MCP DevKit 服务
• 模型上下文协议
• Mapbox 样式规范
• Mapbox API 文档
• 令牌权限范围参考

何时使用此技能

在以下情况下调用此技能：

• 借助 AI 搭建 Mapbox 开发环境
• 通过 AI 创建或修改 Mapbox 样式
• 以编程方式管理访问令牌
• 在开发过程中验证 GeoJSON 或表达式
• 在 AI 指导下学习 Mapbox API
• 自动化样式生成工作流
• 使用 AI 编码助手构建 Mapbox 应用程序