bikerouter-mcp

bikerouter.de を使って自転車ルートを計画するMCPサーバーです。これはNorbert RennerによるBRouter-Webフロントエンドで、BRouterエンジン(作者:Arndt Brenschede)の上でOpenStreetMapデータをルーティングしています。

任意のMCPクライアント(Claude Code、Claude Desktop、など)から利用でき、*「ライン川沿いのケルンからボンまでのグラベルルートを計画してGPXをください」*のようなリクエストができます。

できること

plan_route出力のサンプル:

**Route** (profile: `trekking`)
Alexanderplatz, Berlin → Brandenburger Tor, Berlin

- Distance: **5.2 km**
- Estimated riding time: **20 min** (⌀ 15.6 km/h, from the profile's physics model)
- Ascent: **80 m** / descent: **60 m**
- Elevation: 35–55 m (start 35 m, end 55 m)

- Surfaces: asphalt 76.9% (4 km), gravel 23.1% (1.2 km)
- Way types: cycleway 38.5% (2 km), residential 38.5% (2 km), track 23.1% (1.2 km)

Open in bikerouter.de: https://bikerouter.de/#map=14/52.518154/13.396327/standard&lonlats=…&profile=trekking

Related MCP server: Hiking MCP Server

インストール

cd bikerouter-mcp
npm install     # also builds via the prepare script
npm test

Claude Codeに登録:

claude mcp add bikerouter -- node /absolute/path/to/bikerouter-mcp/dist/index.js

またはclaude_desktop_config.json / その他のMCPクライアントに追加:

{
  "mcpServers": {
    "bikerouter": {
      "command": "node",
      "args": ["/absolute/path/to/bikerouter-mcp/dist/index.js"]
    }
  }
}

APIキーは不要です — このサービスは無料で認証なしで提供されています。

設定

すべてオプションで、環境変数として設定できます:

BRouter APIへのマッピング

リクエストは、BRouterのServerHandler.javaに記載されている通り、通常のGET /brouter呼び出しです:

/brouter?lonlats=lon,lat|lon,lat&nogos=lon,lat,radius,weight|…&profile=trekking
        &alternativeidx=0&format=geojson&timode=1&straight=0&profile:avoid_unsafe=true

• waypoints → lonlats(場所名は最初にジオコーディングされ、前のウェイポイントに引き寄せられます)

• avoid_areas → nogos(ハード・ノーゴーの場合はweightを省略)

• straight_from → straight(直線レッグ)

• profile_options → profile:NAME=VALUE

• alternative_index → alternativeidx(代替ルートにはを1〜3)

• turn_instructions → timode(GeoJSONレスポンス内の音声ヒント)

GeoJSONレスポンスは局所的に要約されます: トラックの長さ、filtered ascend、total-time、total-energyはトラックのプロパティから得られ、下りはフィルターされた登りと正味の高度変化から導出され、サーフェス/ウェイタイプ/路面の粗さの内訳はmessagesテーブルから集計されます(WayTagsをDistanceで重み付け)。

知っておくべき制限

• ルーティングの品質はOpenStreetMapの品質です。 路面やアクセスタグが欠落していると、予期しない迂回が発生します。必ず返された地図リンクでルートを確認してから走行してください。

• **BRouterには道路名がありません。**そのため、"1.2 km先を右折"のように道路名を含まない案内になります。これはこのサーバーの問題ではなく、エンジン自体の性質です。

• 推定走行時間はプロファイルの物理モデル(ライダーの質量・パワー・抗力)から計算されます。現実的な値にするには、profile_optionsでtotalMass、bikerPower、maxSpeedを上書きしてください。

• 標高はSRTMカバレッジが必要です。北緯約60度以上では、標高なしでトラックが返され、要約にもその旨が記載されます。

• 公開サービスは無料のコミュニティ運営インスタンスです — リクエスト量を控えめにするか、独自のBRouterサーバーを実行してBIKEROUTER_HOSTを設定してください。

• プロファイルはサーバーごとに異なります。list_profilesは標準のBRouter/BRouter-Webプロファイルのトラックカタログを提供しますが、特定ホストが実際に提供するプロファイルを確認するにはverify: trueを渡してください。

テスト

npm testはサーバーをビルドしてnode --testを実行します:

• URL構築、ウェイポイント検証、.brfパラメータ解析、GeoJSONサマリサイザーのユニットテスト

• 疑似BRouterホストに対する実サーバーバイナリへのstdioを経由したMCP通信のエンドツーエンドテスト。ルーティング、GPXエクスポート、プロファイル一覧、BRouterのプレーンテキストエラーレスポンスを適用範囲です

テストは公開サービスに接続しないため、オフラインで実行されます。

ライセンスと謝辞

サーバーコード: MIT。ルートはBRouter(MIT)が実行し、BRouter-Web / bikerouter.deを介して提供されます。地図データは©OpenStreetMap contributors(ODbL)です。