bikerouter-mcp

Un servidor MCP que planifica rutas en bicicleta con bikerouter.de — la interfaz web de BRouter de Norbert Renner sobre el motor BRouter de Arndt Brenschede, que enruta sobre datos de OpenStreetMap.

Apunta cualquier cliente MCP (Claude Code, Claude Desktop, …) a él y pídele cosas como "planifica una ruta de gravel de Colonia a Bonn por el Rin y dame el GPX".

Qué puede hacer

Ejemplo de salida de 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

Instalación

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

Regístralo con Claude Code:

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

o añádelo a claude_desktop_config.json / cualquier otro cliente MCP:

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

No se necesita clave de API — el servicio es gratuito y sin autenticación.

Configuración

Todo opcional, se establece como variables de entorno:

Cómo se mapea sobre la API de BRouter

Las peticiones son llamadas GET /brouter simples, exactamente como se documenta en el ServerHandler.java de 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 (los nombres de lugares se geocodifican primero, sesgados hacia el waypoint anterior)

• avoid_areas → nogos (omite weight para un no-go duro)

• straight_from → straight (tramos en línea recta)

• profile_options → profile:NAME=VALUE

• alternative_index → alternativeidx (1–3 para rutas alternativas)

• turn_instructions → timode (indicaciones de voz en la respuesta GeoJSON)

La respuesta GeoJSON se resume localmente: longitud de la pista, filtered ascend, total-time y total-energy vienen de las propiedades de la pista, el descenso se deriva del ascenso filtrado y del cambio neto de altura, y el desglose de superficie / tipo de vía / suavidad se agrega de la tabla messages (WayTags ponderado por Distance).

Limitaciones que conviene saber

• La calidad del enrutamiento es la calidad de OpenStreetMap. Los tags de superficie o acceso faltantes producen desvíos extraños; siempre comprueba una ruta en el enlace del mapa devuelto antes de pedalearla.

• BRouter no tiene nombres de calles, así que las instrucciones de giro dicen "en 1,2 km gira a la derecha" sin nombre de calle. Es una propiedad del motor, no de este servidor.

• El tiempo de pedaleo estimado viene del modelo físico del perfil (masa del ciclista, potencia, resistencia). Sobrescribe totalMass, bikerPower, maxSpeed mediante profile_options para una cifra realista.

• La elevación necesita cobertura SRTM; por encima de ~60°N/S la pista vuelve sin elevaciones y el resumen lo dice.

• El servicio público es una instancia gratuita y comunitaria — mantén un volumen de peticiones moderado, o ejecuta tu propio servidor BRouter y establece BIKEROUTER_HOST.

• Los perfiles difieren según el servidor. list_profiles incluye un catálogo de los perfiles estándar de BRouter/BRouter-Web; pasa verify: true para comprobar qué sirve realmente un host dado.

Pruebas

npm test construye el servidor y ejecuta node --test:

• pruebas unitarias para la construcción de URLs, validación de waypoints, análisis de parámetros .brf y el resumidor de GeoJSON

• una prueba de extremo a extremo que habla MCP sobre stdio con el binario del servidor real contra un host BRouter simulado, cubriendo enrutamiento, exportación GPX, listado de perfiles y las respuestas de error en texto plano de BRouter

Las pruebas nunca tocan el servicio público, así que se ejecutan sin conexión.

Créditos y licencia

Código del servidor: MIT. Es solo un cliente — el enrutamiento lo hace BRouter (MIT) a través de BRouter-Web / bikerouter.de, sobre datos de mapa © Colaboradores de OpenStreetMap (ODbL).