Lviv Public Transport

Name: Lviv Public Transport
Author: vbhjckfd

作者：vbhjckfdバージョン 1.8.11i★ –iクラウドで動く

レジストリ名io.github.vbhjckfd/timetable-api-node

インストール

概要

作者による説明（英語の原文）

Lviv public transport MCP: stops, timetables, routes, and live vehicle positions. No API key.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi3項目中3項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況i未計測★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: クラウドで動く
トランスポート: Streamable HTTP
カテゴリ: その他

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：3項目中3項目に合格
作者のサーバーで動きます。あなたが頼んだ内容は、作者のサーバーを通ります。
できること：9件（ツール） get_stop_realtime, search_stops, find_routes_between, get_route_static …
レジストリには、入力が必要なキーは載っていません。

必要なもの

クラウドで動くインストール不要。インターネット経由でつながります

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

ウェブ、デスクトップ、モバイルのClaudeで使えます：

Settings → Connectors を開く
Add custom connector を押す
下のアドレスを貼り付けて Add を押す
サインインを求められたら、作者のサービスにサインインする

https://api.lad.lviv.ua/mcp

ターミナルでこれを実行します

claude mcp add --transport http timetable-api-node https://api.lad.lviv.ua/mcp

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "timetable-api-node": {
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "timetable-api-node": {
      "type": "http",
      "url": "https://api.lad.lviv.ua/mcp"
    }
  }
}

ChatGPTがつなげるのは、インターネット上のサーバーだけです：

ウェブ版のChatGPTを開き → Settings → Connectors (Apps)
Create または Add を押す（プランによっては、先に Advanced で Developer mode をオンにする必要があります）
下のアドレスを貼り付け、名前を付けて保存する
サインインを求められたら、作者のサービスにサインインする

https://api.lad.lviv.ua/mcp

メニューの名前は、プランや時期によって少し違うことがあります。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

ツールの名前と説明は、サーバーが2026年11月6日に返したそのままの内容です。書いたのは作者で、私たちではありません。プレーンテキストとして表示しています。

get_stop_realtime
Returns live arrivals at a stop: route, destination, vehicle type, minutes until arrival, and each vehicle's position. Use this as the **default tool** when the user asks about arrivals, departures, or the next bus/tram at a specific stop. Requires a numeric stop ID (shown on sto
search_stops
Finds stops by name (Ukrainian or English transliteration, case-insensitive, partial match) and returns each stop's numeric ID, coordinates, and the routes serving it. Use this as the **first step** when the user names a stop or landmark stop (e.g. "Опера", "Rynok", "Головний вок
find_routes_between
Lists the routes from one place to another: which stop to board, where to get off, the direction's destination, stops in between, and the walk at each end — best first, walking counted. Each end is a stop ID (`from_stop_id`) or coordinates (`from_lat` + `from_lng`), e.g. an addre
get_route_static
Returns static route data: name, long name, vehicle type, colour, the ordered stop list for both directions, and the timetable of departures from the first stop (workday, Saturday and Sunday). Use when the user asks which stops a route serves, where it goes, or its scheduled depa
get_route_realtime
Returns every vehicle currently running on a route: position, the destination it is heading to, and its next stop with estimated arrival. `headways` sums up each direction: how many vehicles run, the live gaps between consecutive vehicles in minutes (front to back), and how often
get_disruptions
Lists closures, detours and moved stops the city announced that are in force today: affected routes, the streets a detour uses, routes to take instead of a suspended one, reason, dates and source. The GTFS stop lists and timetables do not reflect any of this. Use when the user as
get_stops_around_location
Finds stops near a geographic point, returning each stop's numeric ID, name, coordinates, walking distance, and the routes serving it. Use this as the **first step** when the user gives an address or coordinates and you need stop IDs for `get_stop_realtime` or `find_routes_betwee
get_nearby_vehicles
Returns live vehicles near a point, nearest first, each with its route, destination, and distance. Use when the user asks "what transport is near me right now?" or wants a live map around a location. Narrow with `route` when the user cares about one line; prefer `get_route_realti
get_vehicle_info
Returns details for one vehicle by ID: position, route, destination, license plate, and its upcoming stops with names and estimated arrival times. Use when the user wants to follow a particular vehicle, e.g. "where does this tram go next?" or "when will it reach X?". Vehicle IDs

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月6日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント vbhjckfd で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
✓ 合格
エンドポイントが応答する
523ミリ秒で応答（HTTP 200）
– 対象外
OAuthでサインイン
サインイン不要
✓ 合格
ツールの説明に隠れた指示がない
9件のツールの説明を読み、AIへの隠れた指示は見つかりませんでした

その他のほかのサーバーとの比較i

このカテゴリのほかの32398件のうち0%よりスターが多い
このカテゴリのほかの32398件のうち94%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの32398件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Lviv Public Transportは安全ですか？

当てはまる基本チェック3項目のうち3項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

レジストリには必須のキーは載っていません。ただし、最初に使うときにサインインを求めるサーバーもあります。

パソコンで動きますか、それともクラウドですか？

作者のクラウドで動きます。インストール不要でインターネット経由でつながりますが、送った内容は作者のサーバーを通ります。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（1.8.11）がレジストリに届いたのは一昨日です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URLでつながるので、リモートMCPサーバーに対応したアプリ（開発者モードのChatGPTなど）でも使えます。

代わりに使えるものは？

同じカテゴリには：Spec Driven Development, Remote Desktop Commander, AI Deprecations

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

Spec Driven Development

作者：formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

パソコンで動く★ 440MIT14 か月前更新

インストール

Remote Desktop Commander

作者：desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

クラウドで動く★ 211昨日更新

インストール

AI Deprecations

作者：aideprecations.com

AI model shutdown dates, replacements, change feed and webhook alerts for 8 providers.

クラウドで動く今日更新

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Timetable API Node

Express-based API for Lviv transport timetable data with a read-only MCP endpoint.

Requirements

Node.js 26 (see .nvmrc)

Run locally

nvm use

npm install cp .env.dist .env make import # first run, and whenever the GTFS feed changes make start

make import downloads the static GTFS feed (gtfs-import-config.json) and writes the two stores the server reads: database/Timetable (LokiJS: stops, routes, shapes, first-stop schedules) and database/gtfs (SQLite: trips and calendars). Both are gitignored, so a fresh clone has no data until it runs. make import-slim re-imports only the light tables into SQLite and leaves database/Timetable alone.

Configuration

All variables are optional; see .env.dist.

Variable	Default	Purpose
`PORT`	`8080`	HTTP port.
`VEHICLES_LOCATION_URL`	`https://track.ua-gis.com/gtfs/lviv/vehicle_position`	GTFS-RT vehicle positions feed.
`TRIP_UDPDATES_URL`	`https://track.ua-gis.com/gtfs/lviv/trip_updates`	GTFS-RT trip updates feed (the misspelling is the real name).
`MCP_PUBLIC_BASE_URL`	`https://api.lad.lviv.ua`	Base URL used in MCP metadata (icon URL).
`NEW_RELIC_LICENSE_KEY`	—	Enables New Relic APM (see Monitoring).
`NEW_RELIC_APP_NAME`, `NEW_RELIC_LOG_LEVEL`	`timetable-api-node`, `info`	New Relic agent settings.
`PULSE_WORKER_URL`, `PULSE_SIGNAL_SECRET`	—	Signal a Pulse worker on each `/stops/:code/timetable` request; both must be set.
`MCP_URL`	`https://api.lad.lviv.ua/mcp`	Only for the `timetable-mcp` stdio proxy: the remote endpoint it forwards to.

Test

nvm use && make test

TypeScript

The code is TypeScript and runs straight from the .ts sources under Node's built-in type stripping — there is no build step for the server, the GTFS import or the scripts. That means only erasable syntax (no enum, namespace or parameter properties), import type for type-only imports, and relative imports that name the .ts file; tsconfig.json enforces all three.

npm run typecheck   # tsc, no emit

npm run build emits just mcp/stdio.js, the published bin: Node does not strip types inside node_modules, so the npm package has to ship JavaScript. It runs on npm pack/npm publish; the output is not committed.

public/stopOverrides.js is served to browsers as-is, so it stays JavaScript and is type-checked from its JSDoc.

Monitoring

New Relic APM, off unless NEW_RELIC_LICENSE_KEY is set. It also carries errors and the custom metrics recorded through utils/metrics.ts.

New Relic runs as a preloaded agent, so npm start carries the flags:

node -r dotenv/config -r newrelic --import newrelic/esm-loader.mjs index.ts

dotenv/config is preloaded first so .env is populated before the agent reads its configuration. The config file is newrelic.cjs (the agent is CommonJS and this project is ESM) and holds no secrets — the key comes from the environment. /health is excluded from transactions via rules.ignore.

The account is in the EU region; its license key starts with eu01xx and the agent picks the collector from that prefix. Use the 40-character ingest license key, not an NRAK-... user API key.

Cloud Run reads the key from Secret Manager:

gcloud run services update timetable-api-node --region=europe-north1 --project=timetable-252615 --set-secrets=NEW_RELIC_LICENSE_KEY=new-relic-license-key:latest

MCP Server

This service exposes a public read-only MCP endpoint over Streamable HTTP. It speaks MCP revision 2026-07-28 (stateless: server/discover, a per-request _meta envelope, cacheable list results) and still serves 2025-era clients that open with initialize (2025-11-25 back to 2024-11-05).

MCP endpoint: /mcp
Server card: /.well-known/mcp/server-card.json
Discovery hint: /robots.txt (non-standard comment hint)

Production deployment (see cloudbuild.yaml for Cloud Run) serves REST and MCP from [api.lad.lviv.ua](https://api.lad.lviv.ua). The main site [lad.lviv.ua](https://lad.lviv.ua) is the public transport website (this repo still links there in HTML sitemap and tables for people, not for the API host). Use your own origin when running locally.

LLM and `/mcp` flow

An MCP client (Claude, Cursor, or the MCP SDK) talks JSON-RPC over Streamable HTTP to POST /mcp. Tool handlers reuse the same Express actions as the REST API, backed by LokiJS timetable data, GTFS SQLite (via gtfs), and live GTFS-RT feeds (for example track.ua-gis.com).

graph LR;

Client[LLM or MCP client] -->|JSON-RPC Streamable HTTP| Mcp["POST /mcp"]; Mcp --> Tools[Tool handlers]; Tools --> Actions[Express actions]; Actions --> Loki[(LokiJS)]; Actions --> Gtfs[(GTFS SQLite)]; Actions --> Rt[GTFS-RT upstream]; Loki --> Actions; Gtfs --> Actions; Rt --> Actions; Actions --> Tools; Tools --> Mcp; Mcp -->|MCP tool result| Client;

Try the live API

MCP Inspector (local): run npx @modelcontextprotocol/inspector, then open the UI with transport and server URL prefilled (from the inspector README):

http://localhost:6274/?transport=streamable-http&serverUrl=https%3A%2F%2Fapi.lad.lviv.ua%2Fmcp

Postman / curl: call a tool on production

POST https://api.lad.lviv.ua/mcp with Content-Type: application/json and Accept: application/json, text/event-stream — the Streamable HTTP transport rejects a request that does not accept both. The server is stateless: there is no session, so tools/call works on its own without an initialize first. The response arrives as a single SSE event: message frame carrying the JSON-RPC result. This is the 2025-era request shape; a 2026-07-28 request also sends MCP-Protocol-Version: 2026-07-28 and Mcp-Method headers, plus io.modelcontextprotocol/protocolVersion and io.modelcontextprotocol/clientCapabilities in params._meta.

curl -s https://api.lad.lviv.ua/mcp \

-H 'Content-Type: application/json' \ -H 'Accept: application/json, text/event-stream' \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_stop_realtime","arguments":{"stop_id":101}}}'

Example `tools/call` body shape:

"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "get_stop_realtime", "arguments": { "stop_id": 101 } } }

Successful tool responses return a natural-language text summary inside MCP content items (type: "text") — e.g. *"Stop «Площа Ринок»: 6 arrivals. Next: Т02 → «Пасічна» in 3 min."* The full structured payload is in the structuredContent field (for schema-aware clients). Each structuredContent payload follows one contract:

"view": "transit_realtime", "data": { "...": "tool-specific payload" }, "ui_blocks": [ { "type": "map", "data": { "center": [49.84, 24.03], "zoom": 14, "layers": { "stops": "data.stop", "vehicles": "data.arrivals" } } }, { "type": "arrival_list", "data": { "source": "data.arrivals" } } ] }

ui_blocks point into data instead of repeating it. A map block gives the centre and zoom, and layers maps stops, vehicles and polylines to a dot path in the result; every stop and vehicle there has lat/lng, vehicles also bearing. An arrival_list block names the arrivals array to render, already sorted by arrival_minutes (null = no ETA).

Exposed tools

All tools are read-only. Stop IDs are the numeric codes on stop signs, returned as strings ("707"). Route names are the short names on vehicles ("Т30", "А1"); Latin "T30"/"A01" work too, and a bare number is read as an internal route ID. An unknown route or vehicle returns isError: true with a hint on what to pass instead.

Tool	Arguments	Returns
`search_stops`	`query` (string, ≥ 2 chars), `limit` (1–25, default 10)	Stops whose Ukrainian or English name contains every query word (inflection-tolerant: `"опера"` finds «Театр опери та балету»; punctuation and Latin look-alike letters are ignored, so `"пл. ринок"` and `"Cихiв"` match), with `routes`.
`get_stops_around_location`	`latitude`, `longitude`, `radius_meters` (50–3000, default 1000)	Stops near a point, nearest first, with `distance_meters` and `routes`.
`get_stop_realtime`	`stop_id`, `lowfloor_only` (default false)	Live arrivals: `route`, `direction` (destination), `vehicle_type`, `arrival_minutes`, vehicle position, `lowfloor`; `scheduled: true` marks timetable entries shown when no vehicle is predicted.
`find_routes_between`	`from_stop_id` or `from_lat` + `from_lng`; `to_stop_id` or `to_lat` + `to_lng`; `depart_at` or `arrive_by` (`"HH:MM"` Lviv time or ISO 8601, default now)	Routes within a 300 m walk of each stop end (600 m of a point), best first: direct `options` (`board_stop`, `alight_stop`, `destination`, `stops_count`, walk at each end) and `transfer_options` with exactly one interchange inside a 300 m stop cluster. Each option carries `schedule` (timetable estimate: `leave_at`, per-leg `board_at`/`alight_at`, `arrive_at`, `total_minutes`) and, when planning for now, `next_departures` (live, from the boarding stop). Suspended routes and stops a detour skips are left out; `walk_meters` when the ends are a short walk apart.
`get_route_static`	`route_name`, `include_shapes` (default false)	Name, type, colour, stop lists for both directions, first-stop timetable; polylines only on request.
`get_route_realtime`	`route_name`, `direction` (0 or 1, optional)	Vehicles on the route with `destination` and `next_stop` (`id`, `name`, ISO `arrival`); `headways` per direction: vehicle count, live `gaps_minutes` front to back, `scheduled_headway_minutes`.
`get_nearby_vehicles`	`latitude`, `longitude`, `radius_meters` (100–1000, default 500), `route`, `limit` (1–50, default 15), `lowfloor_only` (default false)	Live vehicles nearest first, with `destination` and `distance_meters`; `total` counts all in range.

| get_vehicle_info | vehicle_id | One vehicle: position, route, destination, plate, upcoming stops (id, name, ISO

冒頭だけを表示しています。続きはリポジトリで読めます

Lviv Public Transport

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

その他のほかのサーバーとの比較i

よくある質問

代わりの候補

Spec Driven Development

Remote Desktop Commander

AI Deprecations

作者のREADME

Timetable API Node

Requirements

Run locally

Configuration

Test

TypeScript

Monitoring

MCP Server

LLM and /mcp flow

Try the live API

Exposed tools

LLM and `/mcp` flow