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 キーの取得

routekit.nexterait.com.br/static/signup.html で無料キーを取得できます（月 50 回まで）。

ツール

• calculate_route -- 実際の道路距離と到着予定時刻を使って、地点間の自動車ルートを計算します。経由地、エンコード済みポリラインのジオメトリ、ターンバイターン方式の手順、最大 3 つの代替ルートに対応しています。
• distance_matrix -- 最大 5000 地点間の NxN 距離／所要時間行列を計算します（大規模なセットは透過的に分割し、繰り返しのクエリはキャッシュします）。
• snap_to_road -- 生の GPS 座標を最寄りの道路区間にスナップします。スナップ後の地点、元の地点からの距離、道路名を返します。
• isochrone -- ある地点から車で N 分以内に到達できるエリアを計算します。カバレッジ分析、デポの配置、サービスエリアの定義に役立つ GeoJSON Polygon を返します。
• geocode -- ブラジルの住所または地名を緯度／経度に変換します。対象はブラジルに限定され、社内ジオコーダーを使用するため、サードパーティへの依存はありません。組み込みのファジーフォールバックにより、省略形（「Av」→「Avenida」）、アクセント、トークンの省略に対応します。
• geocode_batch -- 1 回の呼び出しで最大 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 と分けて指定します（セットアップ時間は地点ごとに 1 回だけ加算されます）
  • 技術者／車両の種類ごとに異なる時間を設定する setup_per_type / service_per_type
  • 種類ごとの時間／コスト設定に使用する vehicle.type タグ
  • end_lat / end_lon を指定すると、異なる目的地で終了するオープンルートを設定できます（例：ドライバーが自宅で終了する場合）
  • 車両ごとに profile を指定した、車種混在の車両群（車／自転車／徒歩）
  • include_geometry=true を指定すると、ルートごとにエンコード済みポリラインを返します（地図表示用）
  • matrix_overrides：ユーザー指定の区間ごとの移動時間／距離の上書き値（有料道路ルート、進入制限区域、既知の迂回路向け）
  • 1 リクエストあたり最大 500 件のタスク、250 件の配送、100 台の車両に対応
  • 制約が厳しい場合、ルート単位および手順単位の violations を報告します

例

AI アシスタントに次のように依頼します。

「これらの住所をジオコーディングし、サンパウロで 2 人のドライバー向けに 10 件の配送ルートを最適化してください。ベテランは各訪問先を 20 分で回り、若手は 45 分かかります。タスクを均等に分配し、両方とも同じ倉庫で終了するようにして、地図上に描画できるようルートのポリラインも含めてください。」

AI は geocode を呼び出した後、vehicle.type、service_per_type、balance_mode、end_lat／end_lon、include_geometry を指定して optimize_routes を呼び出します。座標を手動で入力する必要はありません。

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：同じ10個のツールを、https://routekit.nexterait.com.br/v1/<tool_name> への通常の HTTP POST でも利用できるようになりました。認証には同じ 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：1回の呼び出しで最大50件の住所を受け付ける新しいツールです。内部では、同時実行数を制限しながらクエリを並列実行します。
• 混合プロファイルの車両群：optimize_routes が車両プロファイル（car/bike/foot）ごとに個別の距離・所要時間マトリックスを取得するようになりました。プロファイル用のコンテナがデプロイされていない場合は、自動的に car のルーティングにフォールバックします。
• 画像チェックの改善：毎週実行される OSRM イメージのチェックで、レジストリのタグを照会し、安定版のセマンティックバージョニングリリースを順位付けするようになりました（debug/assertions/rc の各バリアントは除外されます）。

1.2.2 の新機能

• マトリックスキャッシュ：距離・所要時間マトリックスへの繰り返しのクエリはローカルキャッシュを利用し、約5倍速く返されます。呼び出し側での設定は不要です。
• 自動チャンク分割：distance_matrix が、クエリを並列のサブブロックに分割して、最大5000件の地点を処理できるようになりました。
• 再試行とバックオフ：上流へのすべての呼び出しで、一時的な障害（接続エラー、5xx）が発生した場合、エラーを返す前に指数バックオフとジッターを用いて再試行するようになりました。
• エラーメッセージの改善：LLM が再試行するかどうかを判断できるよう、「一時的に利用できません」と「結果が見つかりません」を区別します。

1.2.0 の新機能

• ジオコーディング：ブラジル向けの新しい geocode ツールと reverse_geocode ツールです。ユーザーは座標ではなく住所を使って指定できます。サードパーティ API への依存はありません。
• 道路へのスナップ：ルーティングの前に不正確な GPS データを補正する、新しい snap_to_road ツールです。
• 等時間圏：N分以内に到達できるエリアを計算する、新しい isochrone ツールです。
• 技術者のモデル化：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