Kaštan is an open-source companion for occasional personal IDOS searches. Use it as a native macOS app or from a terminal, or integrate its search engine as a Swift library or local MCP server.

Kaštan reads publicly reachable IDOS web pages. It is intended for personal, low-frequency use rather than as a stable or guaranteed data API.

• macOS app — search connections, station boards, and MHD station timetables in a native app.
• CLI — run the same searches on macOS, Windows, or Linux and choose human-readable or structured output.
• Swift library — build IDOS search features into a Swift project.
• MCP server — give a local MCP client read-only access to Kaštan searches.

The command-line package requires Git and Swift 6.3 or newer:

git clone https://github.com/Glutexo/kastan.git
cd kastan
swift test
swift run kastan Praha Brno --time 12:00

To try the native app, open the Xcode project and run the shared KastanApp scheme:

open KastanApp/KastanApp.xcodeproj

README stays focused on getting started. The complete documentation contains platform setup, full feature descriptions, every CLI command, the Swift API, and MCP configuration and tool behavior.

swift build
swift test
swift test --package-path MCPServer
xcodebuild test -project KastanApp/KastanApp.xcodeproj -scheme KastanApp -destination 'platform=macOS'

GitHub Actions runs all three test suites for changes to main and for pull requests.

Kaštan means chestnut in Czech. In Czech public-transport slang, the same word is also used for a passenger.