v0.8.0 — bus_route: direct-route bus routing
v0.8.0 — bus_route: direct-route bus routing (Stage 3a)
New MCP tool bus_route(from_stop, to_stop, city, depart_after?) — direct-route within-city bus routing (no transfers). Stage 3a of the (B) routing engine north-star (臺灣版 NAVITIME).
Added
bus_route— finds direct routes serving both stops (origin before dest, same direction; reuses thebus_find_routesStopOfRouteintersection), each with a board estimate — A2 live ETA (source: live) → next timetabled departure (source: scheduled) → headway/2 expected-wait (source: frequency) — and an arrival time from theBus/Scheduleper-stop timetable delta (source: scheduled) where the route is timetabled, omitted with a note for frequency-only routes (never faked). Ambiguous stop name →matches; no direct route →routes:[] + note(transfers deferred to 3b). Tool count 24 → 25.- New
Bus/Scheduleendpoint +BusSchedulemodels (mixedTimetables/Frequencys).
Honest data ceiling
Probing real TDX shaped the design: bus has A2 real-time per-stop ETA (a now-snapshot) + mixed timetable/frequency schedule, but no static per-segment ride-time source. So board-ETA is live-first; arrival is timetable-backed or honestly omitted; transfers (A2 can't predict a future-time second boarding) are deferred to 3b.
Verification
- 169 offline tests, 0 failures (
BusRouterTests×5,BusRouteToolTests×4 executor,BusScheduledecode, 25-tool JSON-RPC smoke). - Live:
bus_route(歡仔園 → 大觀路一段28巷, Taipei)→ route 234, board in 3 min (source: frequency), arrival omitted (frequency-only route — honest, not faked).
Roadmap
Stage 1 (v0.6.0) TRA time-dependent · Stage 2 (v0.7.0) TRA↔Metro multi-modal · Stage 3a (this release) direct-route bus · Stage 3b bus↔rail multi-modal + transfers · Stage 3c unified RAPTOR core (deferred).
Install
Download che-transport-mcp-0.8.0.mcpb for one-click install in Claude Desktop. Developer ID signed + Apple notarized.