Skip to content

v0.8.0 — bus_route: direct-route bus routing

Choose a tag to compare

@kiki830621 kiki830621 released this 01 Jun 07:07

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 the bus_find_routes StopOfRoute intersection), 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 the Bus/Schedule per-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/Schedule endpoint + BusSchedule models (mixed Timetables / 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, BusSchedule decode, 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.