On va où ? Routing API

« On va où ? » Routing API：MCP 服务

为 AI 助手提供欧洲范围内的地址地理编码，以及自行车、电动自行车、电动滑板车、摩托车、轮椅和步行路线。一次请求即可将地点名称转换为坐标；下一次请求则会返回最多三条路线（安全、均衡、快速），并说明每条路线的特点：自行车道占比、非铺装路面、主干道和高速公路、爬升高度，以及逐向导航步骤。

设置

1. 在 https://console.onvaou.app 创建免费 API 密钥（每月 10,000 次请求，无需信用卡）。
2. 将服务添加到你的 MCP 客户端，例如 Claude Desktop （claude_desktop_config.json）：

{
  "mcpServers": {
    "onvaou-itineraires": {
      "command": "npx",
      "args": ["-y", "onvaou-itineraires-mcp"],
      "env": { "OVO_API_KEY": "ovo_live_..." }
    }
  }
}

Claude Code 使用相同的密钥，只需一行：

claude mcp add -e OVO_API_KEY=ovo_live_... onvaou-itineraires -- npx -y onvaou-itineraires-mcp

服务自带这两种工具：询问“从 Gare de Rennes 到 Thabor park 的安全自行车路线”，助手就会对这两个名称进行地理编码，然后根据返回的坐标规划路线。

工具

geocode_address：将地址、地点名称、车站或兴趣点（query，2 到 200 个字符）转换为按匹配度从高到低排列的经纬度候选结果，每个结果都包含完整标签、类型和置信度分数。type 仅可为 address（门牌地址）、street（街道）、locality（城镇、区）、region（地区）、country（国家）、venue（具名地点：车站、酒店、纪念碑）或 other。可通过 near（根据某个点调整排序；该点必须位于欧洲覆盖范围内）、country（ISO 3166-1 alpha-2）、limit（1 到 5）和 language（en、fr、de、it；默认值为 en，拒绝其他值）缩小搜索范围。虽然接受 it，但地理编码器不会提供意大利语标签：标签会以各地点的当地语言返回（Milano、München）。欧洲范围内的结果来自 Photon（OpenStreetMap）；法国境内的结果来自 IGN Géoplateforme。如果 IGN Géoplateforme 不可用、没有返回结果，或其最佳置信度低于 0.4，则会转由 Photon 处理；source 会说明响应来源。返回的坐标可直接用于 compute_route。搜索有单独的每日额度，不计入每月路线规划额度，因此路线规划前进行搜索无需付费。

compute_route：提供起点和终点（{ "lon": 2.3522, "lat": 48.8566 }）、最多 8 个途经点、mode（bike、ebike、scooter、moto、wheelchair、foot）、variants、avoid（ferries、steps、tolls、highways、unpaved、steep）、导航说明的 language（en、fr、de、es、it、nl、pt），以及是否包含步骤、编码折线和海拔剖面。请提供坐标：如果只有地点名称，请先调用 geocode_address。

这两种工具均为只读，会先以简短易读的摘要作答，然后以 JSON 格式提供相同的数据，并报告调用所用额度：地理编码器今日已使用的搜索次数，以及路线规划器本月已使用的请求次数。覆盖范围：欧洲。每个答案都包含自己的 attribution 字符串，搜索结果还会说明服务来源 source：展示任何路线或结果时，请同时显示其 attribution。

文档：https://onvaou.app/developers/routing-api.html 代码示例：https://github.com/onvaou-app/routing-api-examples

开发

npm install
npm test   # 11 tests, including a real MCP client over stdio against a mock API

许可证：MIT，© 2026 OVO SAS。API 条款：https://onvaou.app/cgv-api