gtfs-one-mcp 1.3.0

package/dist/types.d.ts

@@ -0,0 +1,229 @@
+/**
+ * Response shapes for the GTFS One REST API (`/wp-json/gtfs-one/v1/*`).
+ *
+ * These mirror the actual JSON returned by a live GTFS One site (verified against
+ * a production install), not the idealized shapes in the spec — where they differ,
+ * reality wins. Notably: `/stops/search` and `/stops/nearby` wrap results in a
+ * `stops` array, and RT vehicles use `id`/`next_eta`/`next_stop` (not the
+ * `vehicle_id`/`speed` the spec sketches).
+ */
+export interface Feed {
+    id: string;
+    name: string;
+    url: string;
+    active: boolean;
+    logo?: number;
+    rt_vehicles?: string;
+    rt_trips?: string;
+    rt_alerts?: string;
+}
+/** One route serving a stop, with its next scheduled departure times. */
+export interface RouteAtStop {
+    route_id: string;
+    name: string;
+    color: string;
+    url?: string;
+    next: string[];
+}
+export interface NearbyStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+    distance_m: number;
+    distance_text: string;
+    is_timepoint: boolean;
+    routes: RouteAtStop[];
+}
+export interface NearbyStopsResponse {
+    stops: NearbyStop[];
+}
+export interface SearchStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+    label: string;
+    type: string;
+}
+export interface SearchStopsResponse {
+    stops: SearchStop[];
+}
+export interface Departure {
+    route_id: string;
+    name: string;
+    color: string;
+    url?: string;
+    headsign: string;
+    time: string;
+    minutes: number;
+}
+export interface DeparturesResponse {
+    stop: {
+        id: string;
+        name: string;
+        code: string;
+    };
+    departures: Departure[];
+    ts: number;
+}
+export interface MapStop {
+    id: string;
+    name: string;
+    code: string;
+    lat: number;
+    lon: number;
+}
+/** A shape point is a [latitude, longitude] pair. */
+export type ShapePoint = [number, number];
+export interface RouteMapResponse {
+    shapes: ShapePoint[];
+    stops: MapStop[];
+}
+export interface SystemRoute {
+    route_id: string;
+    name: string;
+    long_name: string;
+    color: string;
+    shapes: ShapePoint[];
+    stops: MapStop[];
+}
+export interface SystemMapResponse {
+    routes: SystemRoute[];
+}
+export interface AlertActivePeriod {
+    start: number | null;
+    end: number | null;
+}
+export interface Alert {
+    id: string;
+    header: string;
+    description: string;
+    url: string;
+    /** GTFS-RT Cause enum (integer). Translate before showing to a human. */
+    cause: number | null;
+    /** GTFS-RT Effect enum (integer). */
+    effect: number | null;
+    /** GTFS-RT SeverityLevel enum (integer). */
+    severity: number | null;
+    routes: string[];
+    stops: string[];
+    active_period: AlertActivePeriod[];
+}
+export interface AlertsResponse {
+    alerts: Alert[];
+    ts?: number;
+}
+export interface Vehicle {
+    id: string;
+    lat: number;
+    lon: number;
+    bearing: number | null;
+    route_id: string;
+    trip_id: string;
+    direction_id: number | null;
+    stop_id: string | null;
+    status: number | null;
+    timestamp: number | null;
+    route_name: string;
+    color: string;
+    direction: string | null;
+    next_stop: string | null;
+    next_eta: number | null;
+}
+export interface VehiclesResponse {
+    vehicles: Vehicle[];
+    ts?: number;
+}
+export interface GeocodeResponse {
+    lat: number;
+    lon: number;
+    label: string;
+}
+export interface PlanStopRef {
+    id: string;
+    name: string;
+    code?: string;
+    lat?: number | null;
+    lon?: number | null;
+}
+export interface PlanRoute {
+    id: string;
+    name: string;
+    short_name?: string;
+    long_name?: string;
+    color?: string;
+    text_color?: string;
+}
+export interface PlanFare {
+    status: "exact" | "partial" | "unavailable" | "cross_agency";
+    total: string | null;
+    currency: string;
+    by_category?: Record<string, string>;
+    note?: string;
+    fallback_routes?: string[];
+}
+export interface PlanConnection {
+    leg1_arrive: string;
+    leg2_depart: string;
+    wait_min: number;
+}
+/** One scheduled departure for a route option (with connection detail if a transfer). */
+export interface PlanTime {
+    depart: string;
+    arrive: string;
+    duration_min: number;
+    connection?: PlanConnection;
+}
+export interface PlanWalk {
+    meters: number;
+    display: string;
+    minutes: number;
+    stop?: PlanStopRef;
+}
+export interface PlanOptionLeg {
+    type: "transit";
+    route: PlanRoute;
+    headsign?: string;
+    board_stop: PlanStopRef;
+    alight_stop: PlanStopRef;
+    intermediate_stops?: number;
+}
+/** One route (or route pair) that connects the origin and destination. */
+export interface PlanOption {
+    transfers: number;
+    duration_min: number;
+    routes: PlanRoute[];
+    service_days: string[];
+    from_stop?: PlanStopRef | null;
+    to_stop?: PlanStopRef | null;
+    transfer_at?: PlanStopRef | null;
+    access?: PlanWalk | null;
+    egress?: PlanWalk | null;
+    times: PlanTime[];
+    next_service_date?: string | null;
+    next_times?: PlanTime[];
+    fare: PlanFare;
+    legs: PlanOptionLeg[];
+    walk_only?: boolean;
+    walk?: PlanWalk;
+}
+export interface PlanResponse {
+    query?: {
+        from?: unknown;
+        to?: unknown;
+        tz?: string;
+        unit_system?: string;
+        rider_category?: string;
+    };
+    date?: string;
+    options: PlanOption[];
+    reason?: string;
+    message?: string;
+    next_service_date?: string;
+    nearest_stop?: PlanStopRef;
+    nearest_stop_distance?: string;
+    ts?: number;
+}

package/dist/types.js

@@ -0,0 +1,11 @@
+/**
+ * Response shapes for the GTFS One REST API (`/wp-json/gtfs-one/v1/*`).
+ *
+ * These mirror the actual JSON returned by a live GTFS One site (verified against
+ * a production install), not the idealized shapes in the spec — where they differ,
+ * reality wins. Notably: `/stops/search` and `/stops/nearby` wrap results in a
+ * `stops` array, and RT vehicles use `id`/`next_eta`/`next_stop` (not the
+ * `vehicle_id`/`speed` the spec sketches).
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG"}

package/gtfs-one.config.example.json

@@ -0,0 +1,7 @@
+{
+  "gtfs_one_url": "https://your-agency-site.org",
+  "feed_id": "default",
+  "cache_ttl_seconds": 30,
+  "agency_name": "Your Transit Agency",
+  "agency_description": "Public transit serving your service area. Describe the cities, landmarks, and regions covered so the AI knows what this server is for."
+}

package/package.json

@@ -0,0 +1,58 @@
+{
+  "name": "gtfs-one-mcp",
+  "version": "1.3.0",
+  "description": "Model Context Protocol server for any GTFS One transit site. Lets AI assistants query bus stops, schedules, routes, live vehicle positions, and service alerts from an agency's live GTFS data. Runs locally (stdio) or as a hosted remote connector (Streamable HTTP).",
+  "license": "GPL-2.0-or-later",
+  "author": "Digital Mountaineers",
+  "homepage": "https://github.com/digital-mountaineers/gtfs-one-mcp#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/digital-mountaineers/gtfs-one-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/digital-mountaineers/gtfs-one-mcp/issues"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gtfs",
+    "gtfs-realtime",
+    "transit",
+    "public-transit",
+    "bus",
+    "wordpress",
+    "claude",
+    "ai"
+  ],
+  "type": "module",
+  "bin": {
+    "gtfs-one-mcp": "dist/index.js",
+    "gtfs-one-mcp-http": "dist/http.js"
+  },
+  "files": [
+    "dist",
+    "gtfs-one.config.example.json",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "start:http": "node dist/http.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "express": "^5.1.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/express": "^5.0.0",
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.0"
+  }
+}