Gtfs Mcp Server

Nasza aplikacja udostępnia MCP po HTTP, dlatego skorzystaliśmy z MCP Inspector.

Po włączeniu aplikacji należy w terminalu, w folderze projektu, wykonać: npx -y @modelcontextprotocol/inspector owtorzy się w przeglądarce mcp inspector.

Należy uzupełnić:

• Transportation type: Streamabale http
• URL: http://localhost:8080/mcp i kliknąć "Connect".

Następnie należy w Tools wybrać "List tools"

Aplikacja Spring Boot integrująca dane GTFS Realtime (położenie pojazdów) oraz GTFS Static (rozkłady jazdy) komunikacji miejskiej w Krakowie. Udostępnia API REST do pobierania losowych odjazdów oraz wyszukiwania najszybszych połączeń bezpośrednich.

Co robi aplikacja

Aplikacja realizuje dwa główne zadania:

1. Obsługa Danych Realtime (Kamień Milowy 1)

• Pobiera plik TripUpdates.pb (Protobuf) z API ZTP Kraków.
• Parsuje dane binarne do obiektów Java.
• Wykorzystuje mechanizm Cache (@Cacheable, @CachePut) dla wydajności i odciążenia serwera ZTP.
• Wystawia endpoint zwracający losowy, aktualny odjazd tramwaju/autobusu.

2. Wyszukiwarka Połączeń i Baza Danych (Kamień Milowy 2)

• Pobiera i przetwarza plik GTFS_KRK.zip (dane statyczne: przystanki, trasy, kalendarz, czasy przejazdów).
• Importuje dane do lokalnej bazy SQLite przy starcie aplikacji (zabezpieczenie przed duplikacją danych).
• Posiada wyszukiwarkę najszybszych połączeń bezpośrednich między dwoma przystankami.
• Uwzględnia:
  • Kalendarz kursowania (dni tygodnia + wyjątki z calendar_dates.txt).
  • Opóźnienia rzeczywiste (Realtime Delay) pobierane na żywo z modułu Realtime.

Architektura Aplikacji

graph LR
%% Aktorzy i Systemy Zewnętrzne
    Client((Użytkownik))
    AI_Client((Klient AI / MCP))
    ZTP_Real[("ZTP API<br/>(Realtime PB)")]
    ZTP_Static[("ZTP API<br/>(Static ZIP)")]
    DB[("Baza SQLite<br/>(trams.db)")]

%% Aplikacja
    subgraph "Aplikacja: trams_web"
        style Client fill:#1e88e5,color:white
        style AI_Client fill:#9c27b0,color:white
        style ZTP_Real fill:#546e7a,color:white
        style ZTP_Static fill:#546e7a,color:white
        style DB fill:#546e7a,color:white

    %% 1. Warstwa Prezentacji
        subgraph "Warstwa Prezentacji"
            DepController["DepartureController<br/>(/departure)"]
            ConnController["DirectConnectionController<br/>(/connections)"]
            McpTools["TramsMcpTools<br/>(MCP Server)"]
        end

    %% 2. Warstwa Biznesowa
        subgraph "Warstwa Biznesowa"
            RealService["GtfsRealtimeService"]
            ConnService["DirectConnectionService"]
            NextService["NextDepartureService"]
            CalendarService["GtfsCalendarService"]
            StopService["StopQueryService"]

            subgraph "Logika wyboru"
                PickerInt("«interface»<br/>DeparturePicker")
                PickerImpl["RandomDeparturePicker"]
            end
        end

    %% 3. Warstwa Dostępu do Danych
        subgraph "Warstwa Danych"
            GtfsClient["GtfsClient<br/>(Cache Realtime)"]
            StaticLoader["GtfsStaticLoader"]
            ImportService["GtfsStaticImportService"]
            Repositories["JPA Repositories"]
        end

    %% Relacje
        Client --> ConnController
        ConnController --> ConnService
        Client --> DepController
        DepController --> RealService

        AI_Client --> McpTools
        McpTools --> ConnService
        McpTools --> NextService
        McpTools --> RealService
        McpTools --> StopService

        ConnService --> Repositories
        ConnService --> CalendarService
        ConnService --> RealService

        NextService --> Repositories
        NextService --> CalendarService
        NextService --> RealService

        StopService --> Repositories

        RealService --> GtfsClient
        RealService --> PickerInt
        PickerInt -.-> PickerImpl

        Repositories -.-> DB
        GtfsClient -.-> ZTP_Real

        StaticLoader 

... [View full README on GitHub](https://github.com/mateunow/gtfs-mcp-server#readme)