gtfs-pro-mcp 1.0.0 → 1.1.0

package/README.md

@@ -88,6 +88,29 @@ Edit `claude_desktop_config.json` (Settings → Developer → Edit Config) and a
 Restart Claude Desktop, then ask: *"What bus stops are near \<a place in the
 service area\>?"* or *"When's the next bus from \<stop name\>?"*
 
+> **Windows users:** Claude Desktop on Windows can't launch `npx` directly (it's a
+> `.cmd` shim, not an executable), so the server silently fails to start and Claude
+> falls back to web search. Wrap the command in `cmd` instead:
+>
+> ```json
+> {
+>   "mcpServers": {
+>     "gtfs-pro-transit": {
+>       "command": "cmd",
+>       "args": ["/c", "npx", "-y", "gtfs-pro-mcp"],
+>       "env": {
+>         "GTFS_PRO_URL": "https://your-agency-site.org",
+>         "GTFS_PRO_FEED_ID": "default",
+>         "GTFS_PRO_AGENCY_NAME": "Your Transit Agency"
+>       }
+>     }
+>   }
+> }
+> ```
+>
+> After editing, fully **quit** Claude Desktop (right-click the system-tray icon →
+> Quit — closing the window isn't enough) and reopen it.
+
 ## Use with ChatGPT / other MCP clients
 
 Any client that launches a local stdio MCP server works the same way — run
@@ -98,6 +121,46 @@ npm install -g gtfs-pro-mcp
 GTFS_PRO_URL=https://your-agency-site.org gtfs-pro-mcp
 ```
 
+## Remote / hosted connector (Streamable HTTP)
+
+The stdio setup above only works in clients that launch a **local process** (classic
+Claude Desktop, Cursor, etc.). The **Claude apps that use remote connectors** — the
+newer desktop app and **claude.ai on the web** — instead add an MCP server by **URL**.
+For those, run the server in **HTTP mode** and host it somewhere with a public HTTPS
+address; then add that URL as a custom connector.
+
+Run it in HTTP mode:
+
+```bash
+GTFS_PRO_URL=https://your-agency-site.org \
+GTFS_PRO_AGENCY_NAME="Your Transit Agency" \
+PORT=3000 \
+gtfs-pro-mcp-http        # or: npm run start:http
+```
+
+This serves the MCP endpoint at **`/mcp`** (and a `/healthz` check). Extra env:
+
+| Env | Default | Notes |
+|-----|---------|-------|
+| `PORT` | `3000` | Most hosts inject this automatically |
+| `MCP_AUTH_TOKEN` | — | Optional. If set, clients must send `Authorization: Bearer <token>`. Leave unset for an open server — the transit data is public. |
+
+### Deploy
+
+- **Docker:** a `Dockerfile` is included — `docker build -t gtfs-pro-mcp . && docker run -p 3000:3000 -e GTFS_PRO_URL=… -e GTFS_PRO_AGENCY_NAME=… gtfs-pro-mcp`
+- **Render / Railway / Fly.io (Node):** build `npm install && npm run build`, start `npm run start:http`, set the env vars. A `render.yaml` blueprint is included; Render gives you HTTPS automatically.
+- **Your own VPS:** run behind nginx/Caddy with TLS, proxying to the Node port.
+
+The data is public and read-only, so an open endpoint is fine; add `MCP_AUTH_TOKEN`
+if you'd rather gate it.
+
+### Add it to Claude
+
+In the Claude desktop app or claude.ai: **Settings → Connectors → Add custom
+connector**, give it a name, and paste your server's URL ending in **`/mcp`**
+(e.g. `https://gtfs-pro-mcp.onrender.com/mcp`). Then ask a transit question and
+you'll see the `gtfs-pro-transit` tools used.
+
 ## Local development
 
 ```bash
@@ -109,12 +172,18 @@ node test/smoke.mjs # exercise all 9 tools against a live site
 ## How it fits together
 
 ```
-AI assistant  ──MCP/stdio──►  gtfs-pro-mcp  ──HTTPS──►  WP GTFS Pro REST API
-(Claude, GPT)                 (this package)            /wp-json/wp-gtfs-pro/v1/*
+Local (stdio):
+AI client  ──MCP/stdio──►  gtfs-pro-mcp  ──HTTPS──►  WP GTFS Pro REST API
+(Desktop)                  (local process)           /wp-json/wp-gtfs-pro/v1/*
+
+Remote (Streamable HTTP):
+AI client  ──MCP/HTTPS──►  gtfs-pro-mcp-http  ──HTTPS──►  WP GTFS Pro REST API
+(web/app)                  (hosted service /mcp)          /wp-json/wp-gtfs-pro/v1/*
 ```
 
-A future release adds a Streamable-HTTP transport so the server can run as a
-hosted remote service (one endpoint per agency) instead of a local process.
+Both transports share the same nine tools and config — pick stdio for local
+clients (Claude Desktop, Cursor) or HTTP for connector-based clients (the Claude
+app, claude.ai web, ChatGPT).
 
 ## License
 

package/dist/http.d.ts

@@ -0,0 +1,17 @@
+#!/usr/bin/env node
+/**
+ * GTFS Pro MCP server — Streamable HTTP entry point (remote / hosted transport).
+ *
+ * This lets the server run as a public service that AI clients add as a "custom
+ * connector" by URL — Claude (desktop + web), ChatGPT, etc. — with no local
+ * install. It implements the MCP Streamable HTTP transport with per-client
+ * sessions, exposes a single `/mcp` endpoint (POST to send, GET for the SSE
+ * stream, DELETE to end a session), plus `/healthz`.
+ *
+ * Config is the same as the stdio server (GTFS_PRO_URL, etc.). Extra env:
+ *   PORT             - listen port (default 3000; most hosts inject this)
+ *   MCP_AUTH_TOKEN   - optional. If set, clients must send `Authorization:
+ *                      Bearer <token>`. Leave unset for an open server (the
+ *                      underlying transit data is public anyway).
+ */
+export {};

package/dist/http.js

@@ -0,0 +1,121 @@
+#!/usr/bin/env node
+/**
+ * GTFS Pro MCP server — Streamable HTTP entry point (remote / hosted transport).
+ *
+ * This lets the server run as a public service that AI clients add as a "custom
+ * connector" by URL — Claude (desktop + web), ChatGPT, etc. — with no local
+ * install. It implements the MCP Streamable HTTP transport with per-client
+ * sessions, exposes a single `/mcp` endpoint (POST to send, GET for the SSE
+ * stream, DELETE to end a session), plus `/healthz`.
+ *
+ * Config is the same as the stdio server (GTFS_PRO_URL, etc.). Extra env:
+ *   PORT             - listen port (default 3000; most hosts inject this)
+ *   MCP_AUTH_TOKEN   - optional. If set, clients must send `Authorization:
+ *                      Bearer <token>`. Leave unset for an open server (the
+ *                      underlying transit data is public anyway).
+ */
+import express from "express";
+import { randomUUID } from "node:crypto";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { isInitializeRequest } from "@modelcontextprotocol/sdk/types.js";
+import { loadConfig } from "./config.js";
+import { ApiClient } from "./api-client.js";
+import { createServer } from "./server.js";
+const config = loadConfig();
+const api = new ApiClient(config); // shared across sessions → shared response cache
+const PORT = Number(process.env.PORT || 3000);
+const AUTH = (process.env.MCP_AUTH_TOKEN || "").trim();
+const app = express();
+app.use(express.json({ limit: "1mb" }));
+// CORS — required for browser-based MCP clients (e.g. claude.ai web). The
+// session id travels in the `mcp-session-id` header, so it must be allowed and
+// exposed. Data is public, so origin is open.
+app.use((req, res, next) => {
+    res.setHeader("Access-Control-Allow-Origin", req.headers.origin || "*");
+    res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+    res.setHeader("Access-Control-Allow-Headers", "Content-Type, Authorization, mcp-session-id, mcp-protocol-version, last-event-id");
+    res.setHeader("Access-Control-Expose-Headers", "mcp-session-id");
+    res.setHeader("Vary", "Origin");
+    if (req.method === "OPTIONS") {
+        res.sendStatus(204);
+        return;
+    }
+    next();
+});
+/** Optional bearer-token gate. Returns true if the request may proceed. */
+function authorized(req, res) {
+    if (!AUTH)
+        return true;
+    if (req.headers.authorization === `Bearer ${AUTH}`)
+        return true;
+    res.status(401).json({
+        jsonrpc: "2.0",
+        error: { code: -32001, message: "Unauthorized" },
+        id: null,
+    });
+    return false;
+}
+app.get("/healthz", (_req, res) => {
+    res.json({ ok: true, agency: config.agencyName, site: config.gtfsProUrl });
+});
+app.get("/", (_req, res) => {
+    res.type("text/plain").send(`gtfs-pro-mcp (Streamable HTTP) for ${config.agencyName}. ` +
+        `MCP endpoint: POST ${"/mcp"}. Add this server's URL as a custom connector in your AI client.`);
+});
+// Live sessions, keyed by the transport's session id.
+const transports = new Map();
+const sid = (req) => {
+    const h = req.headers["mcp-session-id"];
+    return Array.isArray(h) ? h[0] : h;
+};
+// POST /mcp — client → server messages. An initialize request with no session
+// id spins up a fresh session+server; everything else must carry a known id.
+app.post("/mcp", async (req, res) => {
+    if (!authorized(req, res))
+        return;
+    const id = sid(req);
+    let transport = id ? transports.get(id) : undefined;
+    if (!transport) {
+        if (id || !isInitializeRequest(req.body)) {
+            res.status(400).json({
+                jsonrpc: "2.0",
+                error: { code: -32000, message: "Bad Request: no valid session ID for a non-initialize request" },
+                id: null,
+            });
+            return;
+        }
+        transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => randomUUID(),
+            onsessioninitialized: (newId) => {
+                transports.set(newId, transport);
+            },
+        });
+        transport.onclose = () => {
+            if (transport.sessionId)
+                transports.delete(transport.sessionId);
+        };
+        const server = createServer(config, api);
+        await server.connect(transport);
+    }
+    await transport.handleRequest(req, res, req.body);
+});
+// GET /mcp (open the SSE stream) and DELETE /mcp (end the session) both operate
+// on an existing session.
+async function existingSession(req, res) {
+    if (!authorized(req, res))
+        return;
+    const id = sid(req);
+    const transport = id ? transports.get(id) : undefined;
+    if (!transport) {
+        res.status(400).send("Invalid or missing session ID");
+        return;
+    }
+    await transport.handleRequest(req, res);
+}
+app.get("/mcp", existingSession);
+app.delete("/mcp", existingSession);
+app.listen(PORT, () => {
+    console.error(`gtfs-pro-mcp ready (http) — listening on :${PORT}, agency: ${config.agencyName}, ` +
+        `site: ${config.gtfsProUrl}${AUTH ? " [auth required]" : ""}`);
+});
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,10 +1,10 @@
 #!/usr/bin/env node
 /**
- * GTFS Pro MCP server — entry point.
+ * GTFS Pro MCP server — stdio entry point.
  *
- * Loads configuration, builds the API client, registers the nine transit tools,
- * and speaks MCP over stdio (the transport Claude Desktop / ChatGPT desktop use
- * to launch a local server). All diagnostics go to stderr so they never corrupt
- * the stdout JSON-RPC stream.
+ * Loads configuration, builds the server, and speaks MCP over stdio (the
+ * transport Claude Desktop / Cursor / ChatGPT desktop use to launch a local
+ * server). For the hosted/remote transport see `http.ts`. All diagnostics go to
+ * stderr so they never corrupt the stdout JSON-RPC stream.
  */
 export {};

package/dist/index.js

@@ -1,32 +1,22 @@
 #!/usr/bin/env node
 /**
- * GTFS Pro MCP server — entry point.
+ * GTFS Pro MCP server — stdio entry point.
  *
- * Loads configuration, builds the API client, registers the nine transit tools,
- * and speaks MCP over stdio (the transport Claude Desktop / ChatGPT desktop use
- * to launch a local server). All diagnostics go to stderr so they never corrupt
- * the stdout JSON-RPC stream.
+ * Loads configuration, builds the server, and speaks MCP over stdio (the
+ * transport Claude Desktop / Cursor / ChatGPT desktop use to launch a local
+ * server). For the hosted/remote transport see `http.ts`. All diagnostics go to
+ * stderr so they never corrupt the stdout JSON-RPC stream.
  */
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { loadConfig } from "./config.js";
-import { ApiClient } from "./api-client.js";
-import { registerTools } from "./tools.js";
+import { createServer } from "./server.js";
 async function main() {
     const config = loadConfig();
-    const api = new ApiClient(config);
-    const instructions = `This server provides real-time transit information for ${config.agencyName}.` +
-        (config.agencyDescription ? ` ${config.agencyDescription}` : "") +
-        ` Use the tools to look up bus stops, schedules, routes, live vehicle positions, ` +
-        `and service alerts. Always use the tools for schedule and stop data — never guess ` +
-        `times. Note: realtime tools (get_service_alerts, get_live_vehicles) returning an ` +
-        `empty result is normal and means "nothing active right now," not "no service."`;
-    const server = new McpServer({ name: "gtfs-pro-transit", version: "1.0.0" }, { instructions });
-    registerTools(server, api);
+    const server = createServer(config);
     const transport = new StdioServerTransport();
     await server.connect(transport);
     // Visible in the client's MCP logs; harmless on stderr.
-    console.error(`gtfs-pro-mcp ready — agency: ${config.agencyName}, site: ${config.gtfsProUrl}, ` +
+    console.error(`gtfs-pro-mcp ready (stdio) — agency: ${config.agencyName}, site: ${config.gtfsProUrl}, ` +
         `default feed: ${config.feedId}`);
 }
 main().catch((err) => {

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,GAAG,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,CAAC;IAElC,MAAM,YAAY,GAChB,0DAA0D,MAAM,CAAC,UAAU,GAAG;QAC9E,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,kFAAkF;QAClF,oFAAoF;QACpF,mFAAmF;QACnF,gFAAgF,CAAC;IAEnF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,CACjB,CAAC;IAEF,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAE3B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,wDAAwD;IACxD,OAAO,CAAC,KAAK,CACX,gCAAgC,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,UAAU,IAAI;QAC/E,iBAAiB,MAAM,CAAC,MAAM,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,iCAAkC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;;;;GAOG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAEjF,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,UAAU,EAAE,CAAC;IAC5B,MAAM,MAAM,GAAG,YAAY,CAAC,MAAM,CAAC,CAAC;IAEpC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,wDAAwD;IACxD,OAAO,CAAC,KAAK,CACX,wCAAwC,MAAM,CAAC,UAAU,WAAW,MAAM,CAAC,UAAU,IAAI;QACvF,iBAAiB,MAAM,CAAC,MAAM,EAAE,CACnC,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,iCAAkC,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Shared MCP server factory. Both transports — stdio (`index.ts`) and
+ * Streamable HTTP (`http.ts`) — build their server through here, so the two
+ * surfaces expose the identical 9 tools and instructions.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { Config } from "./config.js";
+import { ApiClient } from "./api-client.js";
+/** The server-level instructions shown to the AI client. */
+export declare function buildInstructions(config: Config): string;
+/**
+ * Create a fully-wired McpServer. Pass a shared ApiClient so multiple HTTP
+ * sessions reuse one response cache; omit it for a standalone (stdio) process.
+ */
+export declare function createServer(config: Config, api?: ApiClient): McpServer;

package/dist/server.js

@@ -0,0 +1,27 @@
+/**
+ * Shared MCP server factory. Both transports — stdio (`index.ts`) and
+ * Streamable HTTP (`http.ts`) — build their server through here, so the two
+ * surfaces expose the identical 9 tools and instructions.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { ApiClient } from "./api-client.js";
+import { registerTools } from "./tools.js";
+/** The server-level instructions shown to the AI client. */
+export function buildInstructions(config) {
+    return (`This server provides real-time transit information for ${config.agencyName}.` +
+        (config.agencyDescription ? ` ${config.agencyDescription}` : "") +
+        ` Use the tools to look up bus stops, schedules, routes, live vehicle positions, ` +
+        `and service alerts. Always use the tools for schedule and stop data — never guess ` +
+        `times. Note: realtime tools (get_service_alerts, get_live_vehicles) returning an ` +
+        `empty result is normal and means "nothing active right now," not "no service."`);
+}
+/**
+ * Create a fully-wired McpServer. Pass a shared ApiClient so multiple HTTP
+ * sessions reuse one response cache; omit it for a standalone (stdio) process.
+ */
+export function createServer(config, api = new ApiClient(config)) {
+    const server = new McpServer({ name: "gtfs-pro-transit", version: "1.0.0" }, { instructions: buildInstructions(config) });
+    registerTools(server, api);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAE3C,4DAA4D;AAC5D,MAAM,UAAU,iBAAiB,CAAC,MAAc;IAC9C,OAAO,CACL,0DAA0D,MAAM,CAAC,UAAU,GAAG;QAC9E,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAChE,kFAAkF;QAClF,oFAAoF;QACpF,mFAAmF;QACnF,gFAAgF,CACjF,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,YAAY,CAAC,MAAc,EAAE,MAAiB,IAAI,SAAS,CAAC,MAAM,CAAC;IACjF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,kBAAkB,EAAE,OAAO,EAAE,OAAO,EAAE,EAC9C,EAAE,YAAY,EAAE,iBAAiB,CAAC,MAAM,CAAC,EAAE,CAC5C,CAAC;IACF,aAAa,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gtfs-pro-mcp",
-  "version": "1.0.0",
-  "description": "Model Context Protocol server for any WP GTFS Pro transit site. Lets AI assistants query bus stops, schedules, routes, live vehicle positions, and service alerts from an agency's live GTFS data.",
+  "version": "1.1.0",
+  "description": "Model Context Protocol server for any WP GTFS Pro 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-pro-mcp#readme",
@@ -26,7 +26,8 @@
   ],
   "type": "module",
   "bin": {
-    "gtfs-pro-mcp": "dist/index.js"
+    "gtfs-pro-mcp": "dist/index.js",
+    "gtfs-pro-mcp-http": "dist/http.js"
   },
   "files": [
     "dist",
@@ -41,13 +42,16 @@
     "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"
   }