プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Bike Router

作者:JonasHeinickeBioバージョン 0.3.0i★ 0iパソコンで動くリポジトリ ↗
レジストリ名io.github.JonasHeinickeBio/bike-router

インストール方法

What it does

Plan bike routes with a self-hosted OSM service: facts only, with weather and sights.

  • Connects パソコンで動く
  • Account or key No key needed · 1 setting to fill in (BIKE_ROUTER_API_URL)
  • Category 旅行・地図・天気

この順位の理由

一覧は利用スコア(100 点満点)で並びます。内訳は次のとおり

人気0/80GitHub スターか週間ダウンロード数。大きい方を 60、小さい方を 20 で数えます
新しさ12/1230 日以内のリリースかコード更新で満点
応答中0/8前回の確認でクラウドのエンドポイントが応答
利用スコア12/100

品質: 基本チェック 3/3 項目に合格(表示のみ、並び順には不使用) · 勢い: データなし (「急上昇」タブでのみ使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Bike Router をインストールして。https://mcp.popnx.com/i/jonasheinickebio-bike-router.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 3/3 合格 · あなたのパソコンで動きます · ✓ コマンド確認済み 2026年11月13日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげますが、先に準備が必要です

設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BIKE_ROUTER_API_URL Address of the running pyBikeRouter API this server asks (http or https). · 初期値 http://127.0.0.1:8000

    説明は英語の原文のままです。

  3. パソコン版 Claude アプリの設定ファイルを開く

    SettingsDeveloperEdit Config

  4. この設定を貼り付けて保存

    {
      "mcpServers": {
        "bike-router": {
          "command": "uvx",
          "args": [
            "bike-router",
            "mcp",
            "serve"
          ],
          "env": {
            "BIKE_ROUTER_API_URL": "http://127.0.0.1:8000"
          }
        }
      }
    }
  5. Claude を終了してもう一度開く

  6. 試してみる

    Bike Router を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Bike Router を使っていると言うか、回答に Bike Router のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Bike Router につなげません

Bike Router はパソコンに入れて使うものですが、ChatGPT は Web 上で動くサーバーにしかつなげません

代わりにできること

A · Bike Router につなげるアプリを使う

  • 設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ) · パソコン版 Claude アプリ(Windows または Mac)のみ。Web やスマホでは使えません
  • 設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)
  • 設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

B · 旅行・地図・天気 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげますが、先に準備が必要です

設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BIKE_ROUTER_API_URL Address of the running pyBikeRouter API this server asks (http or https). · 初期値 http://127.0.0.1:8000

    説明は英語の原文のままです。

  3. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  4. このコマンドを貼り付けて Enter

    claude mcp add --scope user bike-router --env BIKE_ROUTER_API_URL=http://127.0.0.1:8000 -- uvx bike-router mcp serve
  5. Claude Code で /mcp と入力

    Bike Router が一覧にあり、接続済みと表示されれば OK です

  6. 試してみる

    Bike Router を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Bike Router を使っていると言うか、回答に Bike Router のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげますが、先に準備が必要です

設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BIKE_ROUTER_API_URL Address of the running pyBikeRouter API this server asks (http or https). · 初期値 http://127.0.0.1:8000

    説明は英語の原文のままです。

  3. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  4. キーを入力

    Bike Router の設定で BIKE_ROUTER_API_URL が空です。自分のキーを入れて保存します

  5. Cursor の AI チャットを Agent モードで開く

  6. 試してみる

    Bike Router を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Bike Router を使っていると言うか、回答に Bike Router のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげますが、先に準備が必要です

設定を 1 項目入力 (BIKE_ROUTER_API_URL) · 先にパソコンへ Python (uv) を入れてください(1 回だけ)

  1. uv を入れる(まだなければ)

    もう入っていますか?先に確認 · ターミナルを開き、このコマンドを入力して Enter

    uv --version
    • バージョン番号(例 uv …)が出る = 入っています。この手順は飛ばせます
    • "command not found"(Windows では "is not recognized")が出る = まだ入っていないか、入れた直後でターミナルを開き直す必要があります
    ターミナルの開き方

    Mac:⌘ + Space を押し、Terminal と入力して Enter

    Windows:スタートメニューを開き、Windows PowerShell と入力して「開く」

    まだ入っていない場合: uv にはクリック式のインストーラーがありません。uv 公式ページからお使いの OS(macOS か Windows)用の 1 行コマンドをコピーしてターミナルに貼り付けます · Python を別に入れる必要はなく、必要なときに uv が自動で取得します

    uv のダウンロードページを開く ↗

    入れ終わったらターミナルを閉じて開き直し、同じコマンドをもう一度実行します。バージョン番号が出れば完了です: uv --version

    一度入れれば、uv を使うすべてのツールで使えます

  2. 設定を 1 項目入力

    これはプログラムの設定でキーではありません。登録は不要で、作者の説明どおりに入力します。

    • BIKE_ROUTER_API_URL Address of the running pyBikeRouter API this server asks (http or https). · 初期値 http://127.0.0.1:8000

    説明は英語の原文のままです。

  3. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  4. キーを入力

    Bike Router の設定で BIKE_ROUTER_API_URL が空です。自分のキーを入れて保存します

  5. VS Code の AI チャットを Agent モードで開く

  6. 試してみる

    Bike Router を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Bike Router を使っていると言うか、回答に Bike Router のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

JSON 設定は下の「開発者向け」にあります

つまずいたら?Bike Router を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

パソコンにインストール

Claude Code

claude mcp add --scope user bike-router --env BIKE_ROUTER_API_URL=http://127.0.0.1:8000 -- uvx bike-router mcp serve

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router",
        "mcp",
        "serve"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "http://127.0.0.1:8000"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "bike-router": {
      "command": "uvx",
      "args": [
        "bike-router",
        "mcp",
        "serve"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "http://127.0.0.1:8000"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "bike-router": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "bike-router",
        "mcp",
        "serve"
      ],
      "env": {
        "BIKE_ROUTER_API_URL": "http://127.0.0.1:8000"
      }
    }
  }
}

自分で入力する値

  • BIKE_ROUTER_API_URL 必須 env
    Address of the running pyBikeRouter API this server asks (http or https).

説明は英語の原文のままです。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
28/週
接続方法
パソコンで動く
最新バージョンi
0.3.0
レジストリ公開日i
2026年10月27日
コードの最終更新i
2026年11月17日
作者
JonasHeinickeBio
パッケージ
pypi: bike-router
ウェブサイト
github.com
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名は、リポジトリを所有するGitHubアカウント JonasHeinickeBio で確認済みです

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:一昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • – 対象外

    エンドポイントが応答する

    これはパソコンで動くため、インターネット上のエンドポイントはありません

  • – 対象外

    OAuthでサインイン

    パソコンで動き、代わりにローカルの設定を使います

  • … 未チェック

    ツールの説明に隠れた指示がない

    パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

公開済みの脆弱性(OSV.dev)

OSV.dev に bike-router@0.3.0 の登録はありません

このバージョンのパッケージ本体のみ確認。すべての依存関係ではありません · 確認日 2026年11月15日

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/jonasheinickebio-bike-router.svg)](https://mcp.popnx.com/en/servers/jonasheinickebio-bike-router)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

旅行・地図・天気のほかのサーバーとの比較i

  • このカテゴリのほかの2015件のうち0%よりスターが多い
  • このカテゴリのほかの2015件のうち55%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの2015件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Bike Routerは安全ですか?

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか?

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません(サーバー自体がオンラインサービスを呼び出す場合を除きます)。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は一昨日、最新バージョン(0.3.0)がレジストリに届いたのは23 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにPython (uv)も必要です。

代わりに使えるものは?

同じカテゴリには:Mu, Award Travel Finder, Killbottleneck, Whimsical, HasData Google Maps

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

Mu

News, web search, mail, markets, weather, places, files, calendar, contacts. 67 tools, one endpoint.

作者:micro成長中★ 4404 か月前更新

クラウドで動く✓ micro.mu

Whimsical

Create and edit flowcharts, mind maps, wireframes, and docs in Whimsical, or search your workspace.

作者:WhimsicalCode初期★ 112 か月前更新

クラウドで動く✓ 提供元 · whimsical.com
似たものと比べる
これ
Bike Router
MuAward Travel FinderKillbottleneckWhimsicalHasData Google Maps
動く場所パソコンにインストールが必要クラウドで動き、インストール不要クラウドで動き、インストール不要パソコンにインストールが必要クラウドで動き、インストール不要クラウドでもパソコンにインストールでも使える
キーが必要いいえいいえいいえはいいいえはい
Claude で + から追加いいえいいえいいえいいえはいいいえ
基本チェック3/34/43/33/34/45/5
ライセンスMITAGPL-3.0MITMITMITMIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

bike-routing-agent

An OSM-based bike-routing service: a typed, provider-neutral domain model, a full openrouteservice API client plus routing adapter, and a LangGraph workflow that turns a validated route request into an explainable, exportable cycling route.

The LLM (where used) may parse free text, ask clarification questions, and explain a chosen route. It never invents coordinates, geometry, elevation, or route suitability -- all of that comes from OSM-derived routing engines.

Easy install (no programming needed)

Download pybikerouter-easy- .zip from the Releases page, unzip it, install Docker Desktop, and double-click the Start file for your computer. The first start asks one question -- where you ride -- downloads that area's map data, and opens the planner in your browser. Step by step, in plain words: docs/easy-install.md (and START-HERE.txt in the download).

Documentation

The full documentation suite lives in docs/:

DocumentContents
ArchitectureGraph nodes, state, branching, terminal statuses, error model
APIEndpoint contracts, response statuses, artifact serving
ConfigurationEvery environment variable, validation rules, deployment notes
ProvidersProtocols, ORS client/adapter behaviour, geocoders, BRouter/Valhalla adapters, adding a backend
Backend comparisonMeasured ORS vs BRouter behaviour per bike type, combining both engines
GeocodingNominatim vs Pelias, confidence/ambiguity semantics, tuning
Scoring & exportsScore math, uncertainty policy, explanation rules, GeoJSON/GPX
Plan from wordsDescribe a ride in a sentence; an optional LLM turns it into the structured request (never coordinates)
WeatherForecast along the route at your departure time: temperature, rain, wind vs. riding direction (free, keyless providers)
Self-hosted stackRun routing and/or geocoding locally from one OSM extract; hardware requirements and small-PC options
TestingTest layout, mocking conventions, live tests, CI
Web plannerPutting places into the trip; click a point on the map and choose where in the route it goes
iPhone / TailscaleUse the planner from an iPhone as a home-screen app over your tailnet
RoadmapPlanned work and explicit non-goals

Architecture

FastAPI

| v LangGraph RouteAgentState | +--> parse_request (structured input first; LLM extraction is an injectable dependency) +--> validate_request (Pydantic) +--> geocode_locations (Nominatim by default, public or self-hosted; ambiguity -> clarification, never a guess) +--> route_with_provider (openrouteservice; engine-neutral RoutingRequest in, RouteCandidate out) +--> score_candidates (deterministic distance/elevation/warning scoring) +--> explain_and_export (facts-only explanation + GeoJSON/GPX export) | v JSON response + GeoJSON/GPX artifacts

Graph branches:

START -> parse_request

-> validate_request -> (invalid | awaiting_clarification) -> END -> geocode_locations -> (awaiting_clarification | provider_failure) -> END -> route_with_provider -> (no_route | provider_failure) -> END -> score_candidates -> (no_route) -> END -> explain_and_export -> END

Every path ends with an explicit status; the graph never calls a routing provider unless validation and geocoding both succeeded, and it never returns without a terminal status.

Setup

Requires Python 3.11+ and Poetry.

poetry install

cp .env.example .env

poetry install creates an in-project virtualenv (.venv/, see poetry.toml) with both runtime and dev dependencies. Run any command inside it with poetry run , or poetry shell to activate it directly.

Edit .env and set ORS_API_KEY to a valid openrouteservice API key.

Environment variables
VariablePurposeDefault
ORS_API_KEYopenrouteservice API key(required for live routing)
ORS_BASE_URLopenrouteservice base URLhttps://api.openrouteservice.org
ORS_TIMEOUT_SORS request timeout (seconds)10.0
ORS_MAX_RETRIESRetries for timeouts/5xx2
GEOCODER_PROVIDERGeocoder backend: nominatim (public or self-hosted) or pelias (needs a Pelias API behind ORS_BASE_URL, see docs/geocoding.md; refuses the public ORS URL at startup)nominatim
GEOCODER_BASE_URLNominatim base URL (ignored when GEOCODER_PROVIDER=pelias)https://nominatim.openstreetmap.org
GEOCODER_TIMEOUT_SGeocoder request timeout5.0
GEOCODER_USER_AGENTRequired by Nominatim's usage policybike-routing-agent/0.1
GEOCODER_CACHE_TTL_SIn-memory geocode cache TTL3600
GEOCODER_AMBIGUITY_MARGINConfidence gap below which top-2 results are "ambiguous"0.05
GEOCODER_MIN_CONFIDENCEMinimum confidence to auto-accept a top result0.3
VALHALLA_BASE_URLBase URL of a self-hosted Valhalla (meili) serverhttp://localhost:8002
VALHALLA_TIMEOUT_SPer-request Valhalla timeout (seconds)30.0
VALHALLA_MAX_RETRIESRetries for Valhalla timeouts/5xx1
EXPORT_DIRLocal directory for GeoJSON/GPX artifactsexports
DATABASE_URLPostgreSQL/PostGIS URL: records route history, enables /v1/history/* (docs/persistence.md)unset
ARTIFACT_BACKENDlocal or database (artifacts stored in PostgreSQL)local
LOG_LEVELLog levelINFO

Running the API

poetry run uvicorn bike_routing_agent.api:app --reload

The app also serves a built-in web UI (map-based route planner) at http://localhost:8000/, with the interactive API docs at /docs.

Command-line interface

Installing the package exposes a bike-router command (also runnable as python -m bike_routing_agent.cli) organised into subcommand groups:

bike-router route plan --origin "Berlin Hbf" --destination "Potsdam" \

--bike-type gravel --target-distance-km 30 --output plan.json bike-router serve start --port 8000 bike-router docker up # docker compose -f docker/compose.yaml up -d --build bike-router docker logs -f bike-router config show # effective settings, secrets redacted bike-router config check # validate settings against the environment bike-router providers list # provider names and bike-type -> ORS profile map bike-router profile settings --bike-type touring # what a request may tune (route plan --profile-param), from the LinkML schema bike-router route plan ... --format text --gpx best.gpx # alternatives, sight stops, exports bike-router route show plan.json # a saved plan again; route export writes any alternative bike-router poi along --route plan.json # sights near a route, ranked by fame bike-router brouter needed|info|download # BRouter map tiles (asks before downloading) bike-router history list|show|stats # past plans (needs DATABASE_URL) bike-router status show # readiness of every component and the active features bike-router chat start # plan routes by chatting (docs/chat.md)

Everything the API and the web form do is available from the CLI -- see docs/cli.md.

route plan --text "50 km gravel loop from Braunschweig" uses the optional LLM parser (docs/llm-parser.md).

route plan accepts lat,lon pairs or place text for --origin, --destination and repeated --via waypoints, prints the JSON result and exits 0 on ready, 1 on clarification/provider failure, 2 on usage errors. With DATABASE_URL set it also records the plan in the route history (best effort; plan_id in the output, --no-record to skip), a forecast along the route at --departure-time (docs/weather.md), and bike-router db migrate / db status manage the schema (docs/persistence.md).

Running with Docker

All container assets live in docker/:

cp .env.example .env        # set ORS_API_KEY

docker compose -f docker/compose.yaml up --build

Open http://localhost:8000/ for the web UI. Route artifacts are stored in the named pybikerouter-exports volume. See docs/self-hosted.md for the optional local routing / geocoding stack -- including what it needs and how to run just one half on a small machine.

Example request
curl -X POST http://localhost:8000/v1/route/plan \

-H 'Content-Type: application/json' \ -d '{ "origin": "Braunschweig Hauptbahnhof", "destination": "Wolfenbüttel", "constraints": { "bike_type": "gravel", "avoid_high_traffic_roads": true, "max_ascent_m": 500 } }'

Example response
{

"status": "ready", "route": { "provider": "ors", "provider_profile": "cycling-regular", "geometry_geojson": {"type": "LineString", "coordinates": []}, "metrics": { "distance_m": 12500, "duration_s": 2700, "ascent_m": 85, "descent_m": 90, "surface_coverage": {}, "unknown_surface_fraction": null }, "score": 0.91, "score_breakdown": {"distance_fit": 1.0, "elevation_fit": 1.0, "warning_penalty": 0.0}, "warnings": [], "provenance": {"provider": "ors", "profile": "cycling-regular"} }, "candidates": [ {"provider": "ors", "provider_profile": "cycling-regular", "score": 0.91}, {"provider": "brouter", "provider_profile": "trekking", "score": 0.84} ], "explanation": "...", "artifacts": { "geojson_url": "/v1/routes/ .geojson", "gpx_url": "/v1/routes/ .gpx" }, "clarification": [], "errors": [] }

If origin/destination are ambiguous or unresolved, status is awaiting_clarification and clarification lists the candidate places to choose from -- no route is generated from a guess.

Bike types

constraints.bike_type selects the routing profile per engine and defaults to gravel. Supported values: road, gravel, touring, mountain, city, ebike, commuter (fast, low-traffic), recumbent. ORS ships four cycling profiles, so e.g. ebike uses cycling-electric while commuter rides on cycling-regular; the self-hosted BRouter provider differentiates further -- gravel, touring, mountain, city, commuter and recumbent each get their own profile, while road and ebike share fastbike (BRouter has no e-assist cost model) (see docs/configuration.md).

Make targets

make lists the everyday commands; they use the project's .venv (or the active environment):

make install       # poetry install

make hooks # the git hooks (commit: lint + types; push: the whole suite) make run # the API with auto-reload (HOST=127.0.0.1 PORT=8000) make check # lint + types + tests without coverage, stops at the first failure make ci # what CI runs: lint, types, tests with the 80 % coverage floor make test-fast ARGS="tests/nodes -k geocode" # a part of the suite (no coverage floor) make deploy # build and restart the local container (bike-router deploy up)

Linting and type che

冒頭だけを表示しています。続きはリポジトリで読めます