bikerouter-mcp

Сервер MCP, который прокладывает веломаршруты с помощью bikerouter.de — веб-интерфейса BRouter-Web от Норберта Реннера на основе движка BRouter Арндта Бреншеде, маршрутизация по данным 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-ключ не нужен — сервис бесплатный и не требует аутентификации.

Конфигурация

Всё опционально, задаётся через переменные окружения:

Как это соотносится с API BRouter

Запросы — это обычные вызовы GET /brouter, точно как описано в ServerHandler.java из 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 км поверните направо» без названия дороги. Это свойство движка, а не этого сервера.

• Расчётное время в пути берётся из физической модели профиля (масса велосипедиста, мощность, сопротивление). Переопределите totalMass, bikerPower, maxSpeed через profile_options для реалистичной оценки.

• Высоты требуют покрытия SRTM; выше ~60°N/S трек возвращается без высот, и сводка сообщает об этом.

• Публичный сервис — это бесплатный экземпляр, поддерживаемый сообществом — соблюдайте умеренность в количестве запросов или запустите собственный сервер BRouter и укажите BIKEROUTER_HOST.

• Профили различаются от сервера к серверу. list_profiles поставляется с каталогом стандартных профилей BRouter/BRouter-Web; передайте verify: true, чтобы проверить, что реально обслуживает данный хост.

Тесты

npm test собирает сервер и запускает node --test:

• модульные тесты для построения URL, проверки путевых точек, разбора параметров .brf и суммаризатора GeoJSON

• сквозной тест, который общается по MCP через stdio с реальным бинарником сервера против заглушки хоста BRouter, покрывая маршрутизацию, экспорт GPX, список профилей и текстовые ответы об ошибках BRouter

Тесты никогда не обращаются к публичному сервису, поэтому они работают офлайн.

Авторство и лицензия

Код сервера: MIT. Это только клиент — маршрутизацию выполняет BRouter (MIT) через BRouter-Web / bikerouter.de, на данных карт © OpenStreetMap contributors (ODbL).