RouteKit - Route Optimization API for Brazil

RouteKit MCP

巴西路线优化 API。首个路线优化 MCP 服务。

安装

npx routekit-mcp

或在 MCP 客户端中进行配置：

Claude Desktop / Claude Code

{
  "mcpServers": {
    "routekit": {
      "command": "npx",
      "args": ["-y", "routekit-mcp"],
      "env": {
        "ROUTEKIT_API_KEY": "YOUR_KEY"
      }
    }
  }
}

直接使用 HTTP（无需安装）

{
  "mcpServers": {
    "routekit": {
      "type": "url",
      "url": "https://routekit.nexterait.com.br/mcp",
      "headers": {
        "X-API-Key": "YOUR_KEY"
      }
    }
  }
}

获取 API Key

在 routekit.nexterait.com.br/static/signup.html 获取免费密钥（每月 50 次调用）

工具

• calculate_route -- 计算点与点之间的驾车路线，并提供真实道路距离和预计到达时间。支持途经点、编码后的折线几何信息、逐向导航步骤，以及最多 3 条备选路线。
• distance_matrix -- 最多 5000 个地点之间的 NxN 距离/时长矩阵（大型数据集会自动分块，重复查询会使用缓存）。
• snap_to_road -- 将原始 GPS 坐标吸附到最近的道路路段。返回吸附后的点、与原始点的距离以及道路名称。
• isochrone -- 从某个点出发，驾车 N 分钟内可到达的区域。返回 GeoJSON 多边形，可用于覆盖范围分析、仓库选址和服务区域定义。
• geocode -- 将巴西地址或地点名称转换为纬度/经度。仅限巴西，使用内部地理编码器，无第三方依赖。内置模糊匹配回退机制，可处理缩写（“Av” -> “Avenida”）、重音符号和词元省略。
• geocode_batch -- 单次调用并行地理编码最多 50 个地址。非常适合处理配送清单或客户列表。
• reverse_geocode -- 将经纬度转换为易读的巴西地址，并返回地址组成部分（道路、社区、城市、州、邮政编码）。
• compare_routes -- 使用多种平衡策略（minimize_vehicles、balance_tasks、minimize_distance）运行 optimize_routes，并列出各项指标的优胜方案，便于并排比较。
• validate_eta -- 在 Python 中模拟预定义路线，并返回实际到达时间及任何约束违规情况。适用于已有固定停靠点顺序、只需计算预计到达时间的场景。
• optimize_routes -- 高级 VRP 求解器：
  • tasks（单地点任务）和/或 shipments（成对的取货+配送，须由同一车辆完成）
  • 约束：时间窗（每个任务可设置多个）、技能、多维容量、休息时间、优先级
  • 每辆车的成本（fixed、per_hour、per_km、per_task_hour）、max_tasks、max_travel_time_min、max_distance_km
  • balance_mode：minimize_vehicles（默认）、balance_tasks 或 minimize_distance
  • 将 setup_min 与 service_min 分开设置（每个地点只收取一次准备时间）
  • 使用 setup_per_type / service_per_type 为不同技师/车辆类型设置不同时间
  • 使用 vehicle.type 标签按类型建模时间/成本
  • 使用 end_lat / end_lon 设置终点不同的开放路线（例如司机最后回家）
  • 支持混合车型车队（汽车 / 自行车 / 步行），每辆车可设置 profile
  • 设置 include_geometry=true 可返回每条路线的编码折线（用于地图）
  • matrix_overrides：用户提供的逐对行驶时间/距离覆盖值（适用于收费路线、限行区域和已知绕行路线）
  • 每次请求最多支持 500 个任务 / 250 个配送 / 100 辆车
  • 当约束较紧时，会报告路线级和步骤级的 violations

示例

向 AI 助手提问：

“对这些地址进行地理编码，并为圣保罗的 2 名司机优化 10 次配送——资深司机每站用时 20 分钟，初级司机每站用时 45 分钟。均衡分配任务，两人的终点都设为同一个仓库，并包含路线折线，以便我在地图上绘制。”

AI 会调用 geocode，然后调用 optimize_routes 并使用 vehicle.type、service_per_type、balance_mode、end_lat/end_lon 和 include_geometry，无需手动输入坐标。

1.4.1 版本更新

• 按工具分析：仪表盘现在会显示 API 密钥调用各工具的明细（以横向条形图展示，并按调用频率排序）。
• 80% 限额警告：用量超过月度限额的 80% 时，仪表盘会显示黄色横幅，提醒你在新调用被拒绝前升级套餐。/billing/usage 还会提供 threshold_80 和 threshold_100 标记。
• 欢迎邮件：新客户完成 OTP 验证后会立即收到一封引导邮件，其中包含他们的 API 密钥、可直接粘贴的 Claude Desktop 配置、curl 代码片段和文档链接。

1.4.0 版本更新

• calculate_route 分步导航：传入 include_steps=true，即可获取各步骤的导航动作列表，包括街道名称、距离和时长。
• calculate_route 备选路线：传入 alternatives=1..3，即可获取备选路线（适用于比较“最快与最短”或“收费与不收费”等方案）。
• 模糊地理编码：geocode 现在会在精确查询无结果时，自动重试并扩展缩写（“Av” → “Avenida”）、规范化重音符号并采用词元删减启发式方法。响应会通过 variant_used 显示匹配成功的转换方式。设置 fuzzy=false 可禁用此功能。
• REST API：现在也可通过 https://routekit.nexterait.com.br/v1/<tool_name> 下的普通 HTTP POST 调用同样的 10 个工具。使用相同的 X-API-Key 认证和计量方式。公开的 GET /v1/ 会列出所有端点及其说明。适用于不支持 MCP 的集成。
• 账单门户返回流程：用户在 Stripe 管理订阅后，会返回仪表盘并看到成功横幅，而不是原始 JSON 页面。

1.3.0 版本更新

• compare_routes 工具：通过多种策略比较优化结果，并按指标（距离、行程时间、车辆使用数）给出最佳方案。各策略并行运行。
• validate_eta 工具：模拟预定义路线，无需重新优化即可获取实际预计到达时间和违规情况。你提供的顺序将严格遵循。
• optimize_routes 上的 matrix_overrides：使用自定义值覆盖距离/时间矩阵中的指定位置对（收费路线、渡轮、已知绕行路段），无需用户提供整个 NxN 矩阵。

1.2.3 版本更新

• geocode_batch：新增工具，每次调用最多接受 50 个地址。内部会以有限并发数并行执行查询。
• 混合车型车队：optimize_routes 现在会根据车辆配置文件（car/bike/foot）获取独立的距离/时长矩阵。若某个配置文件容器未部署，则会自动回退到 car 路线规划。
• 更智能的镜像检查：每周 OSRM 镜像检查现在会查询注册表标签，并筛选出稳定的 semver 版本（排除 debug/assertions/rc 变体）。

1.2.2 版本更新

• 矩阵缓存：重复的距离/时长矩阵查询会命中本地缓存，返回速度提升约 5 倍。调用方无需进行任何配置。
• 自动分块：distance_matrix 现在最多可处理 5000 个位置，方法是将查询拆分为并行子块。
• 重试与退避：所有上游调用现在都会针对暂时性故障（连接错误、5xx）进行指数退避重试，并加入抖动，然后才返回错误。
• 更清晰的错误消息：区分“暂时不可用”和“未找到结果”，让大模型能够判断是否重试。

1.2.0 版本更新

• 地理编码：新增适用于巴西的 geocode 和 reverse_geocode 工具。用户可以输入地址，而不是坐标。无需依赖第三方 API。
• 吸附到道路：新增 snap_to_road 工具，可在路线规划前清理有噪声的 GPS 数据。
• 等时圈：新增 isochrone 工具，可计算 N 分钟内可到达的区域。
• 技术人员建模：通过 vehicle.type、setup_per_type、service_per_type、costs.per_task_hour，按类型实现更真实的时间和成本估算。
• 开放路线：为每辆车设置 end_lat/end_lon，以支持司机在不同于起点的位置结束行程。
• 多配置文件车队：通过 profile（car/bike/foot/truck）为车辆标注类型。

1.1.0 版本新增内容

• 支持 shipments（取货+配送配对）
• 使用 balance_mode 将任务均匀分配到整个车队
• 使用 include_geometry 返回优化器生成的路线折线
• 现在会在响应中显示路线 violations，以便进行诊断
• 将 setup_min 与 service_min 分开，以准确反映地点成本
• 矩阵限制从 200 个地点提高到 2000 个地点
• 升级高级 VRP 引擎：现已启用 per_km 成本和 max_distance_km 限制

定价

级别	每月调用次数	价格
免费	50	R$ 0
入门版	1,000	R$ 500/月
专业版	10,000	R$ 3,000/月

链接

• 网站
• API 文档
• 用户指南
• 控制面板

提供方

Nextera IT Solutions