OpenRoute MCP

🗺️ OpenRoute MCP

ハイキングやマウンテンバイクなどのアクティビティ向けに、OpenRouteService API を使ってルートを計画する Model Context Protocol（MCP） サーバーです。

注意

免責事項： このサービスが生成するルートは情報提供のみを目的としており、安全性、合法性、または意図された用途への適合性は保証されません。旅程を開始する前に、必ず公式の地図、現地当局、最新の状況を用いてルートを個別に確認してください。ユーザーは、自身の安全と現地の法令および規制の遵守に関するすべてのリスクと責任を負います。

ヒント

ツール呼び出しの結果として返される GPX ファイル全体をコピーし、gpx.studio などのサービスを使って、生成された GPX ファイルを地図に読み込んでください。

🛠️ 利用可能なツール

• 📍 場所の座標候補を検索
  • 引数：
    • location（文字列）：座標を取得する場所
  • 戻り値：エージェントが適切な候補を判断できるよう、利用可能な説明を添えた座標のリスト（10件）
• 🏠 指定した座標の場所（住所）候補を検索
  • 引数：
    • lon（浮動小数点数）：場所の経度
    • lat（浮動小数点数）：場所の緯度
  • 戻り値：指定した座標の近くにあるオブジェクトのリスト
• 🗺️ 出発地から目的地までのルートを作成（経由地の指定も可能）
  • 引数：
    • route_type（文字列）：ルートの種類。例：「cycling-mountain」、「cycling-regular」、「foot-hiking」、「driving-car」
    • from_coordinates（float のリスト）：出発地の座標［経度、緯度］
    • from_coordinates（float のリスト）：目的地の座標［経度、緯度］
    • waypoints（list[list[float]］）：経由地の座標の任意のリスト。形式は [[lon, lat], ...]
  • 戻り値：
    • ルート GPX を含むリソースファイル（例：route://foot-hiking-98.gpx）
    • ルートを可視化した PNG 画像 を含むリソースファイル（例：route://foot-hiking-98.png）
    • ルートをインタラクティブに可視化した HTML を含むリソースファイル（例：ui://foot-hiking-98.html）。ブラウザーで直接開けます
• 📌 エリア内の施設（POI）を検索
  • 引数：
    • bounding_box_coordinates（list[list[float]]）：バウンディングボックスを定義する座標。形式は [[min_lon, min_lat], [max_lon, max_lat]]
    • filters_name（list[string]）：POI を絞り込む任意の名前リスト。例：["Gas station", "Restaurant"]
  • 戻り値：見つかった POI の情報
• 🔎 指定した出発地と目的地の座標の近くにある既知のルートを検索。ルート作成時に、既知のトレイルを通る経由地を提案できます。現在はスイス連邦の api3.geo.admin.ch 🇨🇭 を利用しているため、スイス国内のみで動作します
  • 引数：
    • route_type（文字列）：ルートの種類。例：「cycling-mountain」、「cycling-regular」、「foot-hiking」、「driving-car」
    • from_coordinates（float のリスト）：出発地の座標［経度、緯度］
    • from_coordinates（float のリスト）：目的地の座標［経度、緯度］
  • 戻り値：エージェントが適切なルートを作成できるよう、利用可能な場合は既知のトレイルの経路と説明を返します
• ⏱️ 1 つ以上の出発地点から、指定した時間または距離内に到達できるエリアを計算

  • 引数：

    • coordinates_list：到達可能なエリアを計算する 1 つ以上の座標。形式は [[lon, lat], ...]
    • route_type：ルートの種類。例：「cycling-mountain」、「cycling-regular」、「foot-hiking」、「driving-car」
    • range_type：範囲の種類。time（秒）または distance（メートル）
    • area_range：分析範囲の最大値。時間の場合は秒、距離の場合はメートルで指定します。または、特定の範囲値をカンマ区切りのリストで指定できます

  • 戻り値：GeoJSON 形式の到達可能エリア情報

🗃️ 利用可能なリソース

• 🚏 ルートファイル
  • URL パターン：route://{filename}
  • 種類：GPX（.gpx）、HTML（.html）、または PNG（.png）
  • 説明：ファイル名を指定して、以前に生成したルートファイルを返します。
  • 生成元：create_route_from_to ツール

🔌 クライアントを MCP サーバーに接続

クライアントの手順に従い、デプロイしたサーバーの /mcp URL を使用してください（例：http://localhost:8888/mcp）

たとえば、GitHub Copilot in VSCode の場合、VSCode の UI から新しい MCP サーバーを追加するには、次の手順に従います。

• サイドパネルのチャットを開き（ctrl+shift+i または cmd+shift+i）、右下のモードが Agent に設定されていることを確認します
• コマンドパレットを開き（ctrl+shift+p または cmd+shift+p）、MCP: Open User Configuration を検索します。mcp.json ファイルが開きます

⌨️ stdio トランスポートを使用する

重要

GitHub でログインして openrouteservice.org を開き、OPENROUTESERVICE_API_KEY 環境変数を通じて設定できる API キーを取得してください。

OPENROUTESERVICE_API_KEY=YYY uvx openroute-mcp

VSCode の mcp.json ファイルには、次のように記述します。

{
  "servers": {
    "openroute-mcp": {
      "command": "uvx",
      "args": [
        "openroute-mcp"
      ],
      "env": {
        "OPENROUTESERVICE_API_KEY": "YOUR_API_KEY"
      }
    }
  }
}

重要

MCP サーバーへの接続を開始するには、"openroute-mcp" のすぐ上にある Start をクリックしてください。

レンチとドライバーのボタン 🛠️（Configure Tools...）をクリックすると、個別のツールを有効／無効にできます。

CLI オプションの詳細：

usage: openroute-mcp [-h] [--http] [--port PORT] [--openroute-api OPENROUTE_API] [--openroute-api-key OPENROUTE_API_KEY]
                     [--data-folder DATA_FOLDER] [--no-save] [--no-img] [--no-html]

A Model Context Protocol (MCP) server for building routes using OpenRouteService.

options:
  -h, --help            show this help message and exit
  --http                Use Streamable HTTP transport
  --port PORT           Port to run the server on
  --openroute-api OPENROUTE_API
                        OpenRouteService API URL (default: https://api.openrouteservice.org)
  --openroute-api-key OPENROUTE_API_KEY
                        OpenRouteService API key (default: taken from env var OPENROUTESERVICE_API_KEY)
  --data-folder DATA_FOLDER
                        Folder to save generated routes
  --no-save             Don't save generated routes to disk (also disable image and HTML generation)
  --no-img              Do not add PNG image visualization of the routes to the response (image not supported by all LLMs)
  --no-html            Do not add HTML interactive map for routes to the response

🧑‍💻 開発

開発環境での実行方法と貢献方法の詳細については、CONTRIBUTING.md のページをご覧ください。