Openroute MCP

🚀 🗺️ 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のリスト): 出発地の座標 [経度, 緯度]
    • to_coordinates (floatのリスト): 目的地の座標 [経度, 緯度]
    • waypoints (floatのリストのリスト): 任意の経由地点の座標 [[経度, 緯度], ...]
  • 戻り値:
    • ルートのGPXファイル を含むリソースファイル（例: route://foot-hiking-98.gpx）
    • ルートの PNG画像 の可視化を含むリソースファイル（例: route://foot-hiking-98.png）
    • ルートの HTML のインタラクティブな可視化を含むリソースファイル（例: route://foot-hiking-98.html）。ブラウザで直接開くことができます。
• 📌 エリア内の興味のある地点（POI）を検索
  • 引数:
    • bounding_box_coordinates (floatのリストのリスト): 境界ボックスを定義する座標 [[最小経度, 最小緯度], [最大経度, 最大緯度]]
    • filters_name (文字列のリスト): POIをフィルタリングするための任意の名前のリスト。例: ["ガソリンスタンド", "レストラン"]
  • 戻り値: 見つかったPOIの情報
• 🔎 与えられた出発地と目的地の座標の近くの既知のルートを検索。これにより、ルートを作成する際に既知のトレイルを通る経由地点を提案することができます。現在はスイスでのみ機能しています。スイス連邦の api3.geo.admin.ch 🇨🇭 を利用しています。
  • 引数:
    • route_type (文字列): ルートのタイプ。例: "cycling-mountain", "cycling-regular", "foot-hiking", "driving-car"
    • from_coordinates (floatのリスト): 出発地の座標 [経度, 緯度]
    • to_coordinates (floatのリスト): 目的地の座標 [経度, 緯度]
  • 戻り値: エージェントが素敵なルートを構築するのに役立つ、既知のトレイルの軌跡と説明（利用可能な場合）
• ⏱️ 与えられた時間または距離内に到達できるエリアを計算。1つまたは複数の出発地点から。
  • 引数:
    • coordinates_list: 到達可能エリアを計算するための1つ以上の座標 [[経度, 緯度], ...]
    • 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サーバーを追加するには：

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

⌨️ 標準入出力トランスポートを使用する

⚠️ 重要提示

openrouteservice.orgにGitHubでログインし、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"
      }
    }
  }
}

⚠️ 重要提示

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

レンチとドライバーのボタン 🛠️ (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] [--add-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)
  --add-html            Add HTML interactive map for routes to the response (larger context used)

📡 ストリーム可能なHTTPサーバーを使用する

openroute-mcp.onrender.com/mcpなどの実行中のストリーム可能なHTTP MCPサーバーに接続します。

VSCodeの mcp.json には以下のように記述します：

{
  "servers": {
    "openroute-mcp-http": {
      "url": "https://openroute-mcp.onrender.com/mcp",
      "type": "http"
    }
  }
}

⚠️ 重要提示

パブリックMCPサーバーで作成されたルートは、誰でも公開で利用できるようになります。

詳細は VSCode MCP公式ドキュメント を参照してください。

🧑‍💻 開発

開発環境での実行と貢献に関する詳細は、CONTRIBUTING.md ページを確認してください。