Openroute MCP

🚀 🗺️ OpenRoute MCP

OpenRoute MCP 是一個基於 Model Context Protocol (MCP) 的服務器，藉助 OpenRouteService API 來規劃路線，適用於徒步、山地騎行等活動。

⚠️ 重要提示

免責聲明：本服務生成的路線僅用於信息參考，不保證安全、合法或適合您的預期使用。在進行任何行程之前，請始終使用官方地圖、當地管理部門信息和當前實際情況獨立核實路線。用戶需自行承擔所有安全風險以及遵守當地法律法規的責任。

💡 使用建議

複製工具調用結果中返回的整個 GPX 文件，然後使用 gpx.studio 等服務將生成的 GPX 文件加載到地圖上。

🚀 快速開始

連接客戶端到 MCP 服務器

按照您的客戶端說明，使用已部署服務器的 /mcp URL（例如 http://localhost:8888/mcp）。

以 GitHub Copilot in VSCode 為例，通過 VSCode 界面添加新的 MCP 服務器：

• [x] 打開側邊面板聊天窗口（ctrl + shift + i 或 cmd + shift + i），並確保右下角模式設置為 Agent。
• [x] 打開命令面板（ctrl + shift + p 或 cmd + shift + p），搜索 MCP: Open User Configuration，這將打開一個 mcp.json 文件。

⌨️ 使用標準輸入輸出傳輸

⚠️ 重要提示

使用 GitHub 登錄 openrouteservice.org 獲取 API 密鑰，並通過 OPENROUTESERVICE_API_KEY 環境變量提供該密鑰。

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 服務器

連接到正在運行的可流式傳輸 HTTP MCP 服務器，例如 openroute-mcp.onrender.com/mcp。

在 VSCode 的 mcp.json 文件中應包含以下內容：

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

⚠️ 重要提示

在公共 MCP 服務器上創建的路線將對任何人公開可用。

更多詳細信息請參考 VSCode MCP 官方文檔。

✨ 主要特性

🛠️ 可用工具

• 📍 查找地點的可能座標
  • 參數：
    • location（字符串）：要獲取座標的地點
  • 返回值：包含 10 個座標及可用描述的列表，方便智能體確定正確的座標
• 🏠 查找給定座標的可能地點（地址）
  • 參數：
    • lon（浮點數）：地點的經度
    • lat（浮點數）：地點的緯度
  • 返回值：靠近給定座標的對象列表
• 🗺️ 從起點到終點創建路線，可選擇設置途經點
  • 參數：
    • route_type（字符串）：路線類型，例如 "cycling-mountain"、"cycling-regular"、"foot-hiking"、"driving-car"
    • from_coordinates（浮點數列表）：起點座標，格式為 [經度, 緯度]
    • to_coordinates（浮點數列表）：終點座標，格式為 [經度, 緯度]
    • waypoints（浮點數列表的列表）：可選的途經點座標列表，格式為 [[經度, 緯度], ...]
  • 返回值：
    • 包含 路線 GPX 文件 的資源文件（例如 route://foot-hiking-98.gpx）
    • 包含路線 PNG 圖像可視化 的資源文件（例如 route://foot-hiking-98.png）
    • 包含路線 HTML 交互式可視化 的資源文件（例如 route://foot-hiking-98.html），可直接在瀏覽器中打開
• 📌 在某個區域搜索興趣點（POIs）
  • 參數：
    • bounding_box_coordinates（浮點數列表的列表）：定義邊界框的座標，格式為 [[最小經度, 最小緯度], [最大經度, 最大緯度]]
    • filters_name（字符串列表）：可選的興趣點名稱過濾列表，例如 ["加油站", "餐廳"]
  • 返回值：找到的興趣點信息
• 🔎 搜索靠近給定起點和終點座標的已知路線 此功能可在創建路線時建議途經已知路線，目前僅在瑞士可用，藉助了瑞士聯邦的 api3.geo.admin.ch 🇨🇭。
  • 參數：
    • route_type（字符串）：路線類型，例如 "cycling-mountain"、"cycling-regular"、"foot-hiking"、"driving-car"
    • from_coordinates（浮點數列表）：起點座標，格式為 [經度, 緯度]
    • to_coordinates（浮點數列表）：終點座標，格式為 [經度, 緯度]
  • 返回值：已知路線的軌跡和描述（如果可用），幫助智能體構建合適的路線
• ⏱️ 計算從一個或多個起點在給定時間或距離內可到達的區域
  • 參數：
    • coordinates_list：用於計算可到達區域的一個或多個座標，格式為 [[經度, 緯度], ...]
    • 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 工具

🧑‍💻 開發

有關開發運行和貢獻的更多詳細信息，請查看 CONTRIBUTING.md 頁面。