用途：为把 Mapbox MCP Server 集成到生产级 AI 应用、提供地理空间能力，整理运行时集成模式与参考文档。
主要能力：Mapbox MCP Server 是 Model Context Protocol 服务器，向 AI 代理提供地理空间工具。离线工具基于 Turf.js，含距离、方位、中点、点在多边形内、面积、缓冲区、质心、边界框与几何简化，无需 API 调用、即时返回。Mapbox API 工具含路径规划与路线、反向地理编码、POI 类别搜索、等时圈、出行时间矩阵、静态地图图像、GPS 轨迹地图匹配、多站路线优化。工具类还提供服务器版本与 POI 类别列表。
选型要点：直线距离用 distance_tool、bearing_tool、midpoint_tool；路线距离用 directions_tool、matrix_tool；按类别找地点用 category_search_tool；具体地点或地址用 search_and_geocode_tool、reverse_geocode_tool；可达区域用 isochrone_tool；具体路线用 directions_tool。离线工具免费即时、不消耗 token，API 工具需令牌并计入用量，应优先离线、需要实时数据时再用 API。
用法：托管服务器推荐 https://mcp.mapbox.com/mcp，无需安装，用 Authorization: Bearer your_mapbox_token 传令牌。自托管：npm install @mapbox/mcp-server 或 npx @mapbox/mcp-server，并设置 export MAPBOX_ACCESS_TOKEN="your_token_here"。参考文件按需加载：references/pydantic-ai.md、references/crewai.md、references/smolagents.md、references/mastra.md、references/langchain.md、references/custom-agent.md、references/use-cases.md、references/production.md。
适用场景：为 AI 应用或代理添加地理空间能力、构建 Zillow/TripAdvisor/DoorDash 类应用、在 MCP 与直接 API/SDK 间选型、优化生产环境地理操作、错误处理与测试。
限制：资料未提供具体价格、性能数据或完整代码示例，需以官方文档为准。