GalwayBus

GalwayBus is a Kotlin Multiplatform project that provides shared code and platform-specific UI for Android (Jetpack Compose) and iOS (SwiftUI) as part of a Kotlin Multiplatform Mobile (KMM) setup. The README describes a client-side application (maps-enabled) rather than a standalone MCP server. If you’re looking to interact with an MCP server, this repository itself does not expose a runnable server entry point or a ready-made server command. Instead, you would typically run the Gradle build to compile the shared code and platforms, then deploy the resulting app bundles to Android and iOS as you would with any KMM project. The project also notes dependencies like Google Maps via an API key and various Kotlin libraries, which influence how you run and test the apps locally.

If you intend to use its capabilities, you would configure and run the Android app (Jetpack Compose) or the iOS app (SwiftUI) from an IDE like Android Studio or Xcode, and supply required environment variables (e.g., GOOGLE_API_KEY) for maps functionality. The project focuses on UI and shared business logic rather than providing a server-side API for MCP interactions.

Prerequisites:

• Java Development Kit (JDK 11 or newer)
• Kotlin and Gradle (via Android Studio or command line)
• For iOS: Xcode installed on macOS
• Optional: Android Studio for Android development

Step-by-step:

1. Clone the repository: git clone https://github.com/joreilly/GalwayBus.git cd GalwayBus

2. Open the project in the appropriate IDE:

   • Android: Open the Android module in Android Studio and build/run the app
   • iOS: Open the iOS project/workspace in Xcode and build/run

3. Provide required environment variables for maps (as noted in the README):

   • GOOGLE_API_KEY with your Google Maps API key

4. Build the Kotlin Multiplatform project (optional, for command-line builds):

   • ./gradlew build

5. Run the app on a device or emulator as per your IDE guidance.

Notes and tips:

• The project relies on GOOGLE_API_KEY for maps functionality; ensure this is defined in your environment or adjusted in the Gradle build configuration if you modify the maps access.
• This repository demonstrates a Kotlin Multiplatform setup with shared code across Android and iOS, using Kotlin Coroutines, Ktor client, SQLDelight, and Koin for DI. There is no standalone MCP server described in the README, so there is no specific server configuration to run.
• If you’re porting or adapting this to an MCP server workflow, you’d typically need a backend or server component that exposes an API consumed by the client apps; consider adding a server (e.g., Kotlin/Ktor or another backend) and then configure mcp_config with the corresponding command and arguments.