On va où ? Routing API

« On va où ? » ルーティング API：MCP サーバー

AI アシスタント向けに、ヨーロッパ全域の住所ジオコーディングと、自転車、電動自転車、キックボード、オートバイ、車椅子、徒歩でのルート検索を提供します。1回目のリクエストで地名を座標に変換し、次のリクエストで最大3つのルート（安全重視、バランス重視、速さ重視）を返します。各ルートでは、自転車レーンの割合、未舗装路、幹線道路と高速道路、登りの量、ターンバイターン方式の手順を確認できます。

セットアップ

1. https://console.onvaou.app で無料の API キーを作成します（月間10,000リクエスト、クレジットカード不要）。
2. たとえば Claude Desktop のクライアントにサーバーを追加します （claude_desktop_config.json）。

{
  "mcpServers": {
    "onvaou-itineraires": {
      "command": "npx",
      "args": ["-y", "onvaou-itineraires-mcp"],
      "env": { "OVO_API_KEY": "ovo_live_..." }
    }
  }
}

Claude Code では、同じキーを使って1行で設定できます。

claude mcp add -e OVO_API_KEY=ovo_live_... onvaou-itineraires -- npx -y onvaou-itineraires-mcp

サーバーには両方のツールが含まれています。「Gare de Rennes から Thabor park まで安全な自転車ルートを教えて」と尋ねると、アシスタントが2つの地名をジオコーディングし、返された座標間のルートを検索します。

ツール

geocode_address：住所、地名、駅、または POI（query、2～200文字）を、経度・緯度の候補に変換します。候補は最適なものから順に並び、それぞれに完全なラベル、種類、信頼度スコアが付いています。type は address（番地）、street、locality（町、市区町村）、region、country、venue（名称のある場所：駅、ホテル、記念碑）、または other のいずれかで、それ以外はありません。near（指定した地点を中心に順位付けします。地点はヨーロッパの対象範囲内である必要があります）、country（ISO 3166-1 alpha-2）、limit（1～5）、language（en、fr、de、it。デフォルトは en。その他の値は拒否されます）を指定して検索を絞り込めます。it は指定できますが、ジオコーダーはイタリア語のラベルを付けません。その場合、ラベルは各場所の現地語で返されます（Milano、München）。結果はヨーロッパ全域の Photon（OpenStreetMap）から取得されます。フランスでは IGN Géoplateforme から取得し、利用できない場合、結果がない場合、または最良の信頼度が0.4未満の場合は Photon に切り替わります。応答したサービスは source で示されます。返された座標はそのまま compute_route に渡せます。検索には独自の日次上限があり、月間のルート検索枠には加算されないため、ルート検索前の住所検索は無料です。

compute_route：出発地と目的地（{ "lon": 2.3522, "lat": 48.8566 }）、最大8つの経由地、mode（bike、ebike、scooter、moto、wheelchair、foot）、variants、avoid（ferries、steps、tolls、highways、unpaved、steep）、案内の language（en、fr、de、es、it、nl、pt）、および手順、エンコード済みポリライン、高度プロファイルを含めるかどうかを指定します。座標を渡してください。地名しかない場合は、先に geocode_address を呼び出します。

どちらのツールも読み取り専用です。まず短く読みやすい概要を返し、続けて同じデータを JSON 形式で返します。また、呼び出しの利用料金も報告します。ジオコーダーは当日の検索回数、ルーターは今月のリクエスト回数を示します。対象範囲はヨーロッパです。各応答には独自の attribution 文字列が含まれ、検索結果には応答元の source も含まれます。ルートや検索結果を表示する際は、その横に帰属表示を示してください。

ドキュメント：https://onvaou.app/developers/routing-api.html
コード例：https://github.com/onvaou-app/routing-api-examples

開発

npm install
npm test   # 11 tests, including a real MCP client over stdio against a mock API

ライセンス：MIT、© 2026 OVO SAS。API の利用規約：https://onvaou.app/cgv-api