bikerouter-mcp

一个 MCP 服务器，使用 bikerouter.de 规划自行车路线——bikerouter.de 是 Norbert Renner 基于 BRouter 引擎（作者 Arndt Brenschede）开发的 BRouter-Web 前端，在 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

请求是普通的 GET /brouter 调用，与 BRouter 的 ServerHandler.java 中记录的完全一致：

/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 公里后右转”，没有道路名称。这是引擎本身的属性，而非此服务器的属性。

• 预计骑行时间来自配置文件的物理模型（骑行者质量、功率、阻力）。通过 profile_options 覆盖 totalMass、bikerPower、maxSpeed 以获得更实际的数值。

• 海拔需要 SRTM 覆盖；在约 ~60°N/S 以上，轨迹返回时没有海拔数据，摘要中会说明这一点。

• 公共服务是一个免费、社区运行的实例——请保持适度的请求量，或者运行您自己的 BRouter 服务器并设置 BIKEROUTER_HOST。

• 不同服务器的配置文件有所不同。list_profiles 附带一份标准 BRouter/BRouter-Web 配置文件目录；传入 verify: true 可检查给定主机实际提供哪些配置文件。

测试

npm test 构建服务器并运行 node --test：

• 针对 URL 构建、途经点验证、.brf 参数解析和 GeoJSON 汇总器的单元测试

• 一个端到端测试，通过 stdio 与真实服务器二进制文件进行 MCP 通信，并针对一个桩 BRouter 主机，涵盖路由、GPX 导出、配置文件列表和 BRouter 的纯文本错误响应

测试从不访问公共服务，因此可以离线运行。

致谢与许可证

服务器代码：MIT。它仅是一个客户端——路由由 BRouter（MIT）通过 BRouter-Web / bikerouter.de 完成，地图数据 © OpenStreetMap 贡献者（ODbL）。