@iflow-mcp/faaak2-db-mcp 1.0.2 → 1.0.3

package/{src/api-client.ts → build/api-client.js}

@@ -1,4 +1,3 @@
 import { createClient } from "db-vendo-client";
 import { profile as dbProfile } from "db-vendo-client/p/db/index.js";
-
 export const client = createClient(dbProfile, "db-mcp-server");

package/build/index.js

@@ -0,0 +1,108 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { instructions } from "./instructions.js";
+import { registerFindStation } from "./tools/find-station.js";
+import { registerGetDepartures } from "./tools/get-departures.js";
+import { registerFindTrip } from "./tools/find-trip.js";
+import { registerFindJourneys } from "./tools/find-journeys.js";
+function createServer() {
+    const server = new McpServer({ name: "db-mcp", version: "1.0.0" }, { instructions });
+    registerFindStation(server);
+    registerGetDepartures(server);
+    registerFindTrip(server);
+    registerFindJourneys(server);
+    return server;
+}
+if (process.env.PORT) {
+    // Remote: Streamable HTTP transport
+    const { createServer: createHttpServer } = await import("node:http");
+    const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
+    const PORT = parseInt(process.env.PORT, 10);
+    const sessions = new Map();
+    // Session timeout: clean up sessions after 30 min
+    const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
+    setInterval(() => {
+        const now = Date.now();
+        for (const [id, session] of sessions) {
+            if (now - session.createdAt > SESSION_TIMEOUT_MS) {
+                session.transport.close?.();
+                sessions.delete(id);
+                console.log(`Session expired: ${id} (${sessions.size} active)`);
+            }
+        }
+    }, 60_000);
+    const httpServer = createHttpServer(async (req, res) => {
+        const url = new URL(req.url || "/", `http://localhost:${PORT}`);
+        // Health check for Railway
+        if (url.pathname === "/" && req.method === "GET") {
+            res.writeHead(200, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ status: "ok", name: "db-mcp" }));
+            return;
+        }
+        if (url.pathname !== "/mcp") {
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Not found. Use POST /mcp" }));
+            return;
+        }
+        // CORS
+        res.setHeader("Access-Control-Allow-Origin", "https://mcp-builder.de");
+        res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
+        res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
+        res.setHeader("Access-Control-Expose-Headers", "mcp-session-id");
+        if (req.method === "OPTIONS") {
+            res.writeHead(204);
+            res.end();
+            return;
+        }
+        // Parse body for POST
+        let parsedBody = undefined;
+        if (req.method === "POST") {
+            const chunks = [];
+            for await (const chunk of req) {
+                chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
+            }
+            parsedBody = JSON.parse(Buffer.concat(chunks).toString());
+        }
+        // Route by session
+        const sessionId = req.headers["mcp-session-id"];
+        if (sessionId && sessions.has(sessionId)) {
+            const session = sessions.get(sessionId);
+            await session.transport.handleRequest(req, res, parsedBody);
+            return;
+        }
+        if (sessionId && !sessions.has(sessionId)) {
+            // Session expired or lost (e.g. after redeploy) — tell client to re-initialize
+            res.writeHead(404, { "Content-Type": "application/json" });
+            res.end(JSON.stringify({ error: "Session not found. Please start a new session." }));
+            return;
+        }
+        // New session
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: () => crypto.randomUUID(),
+            onsessioninitialized: (id) => {
+                sessions.set(id, { server, transport, createdAt: Date.now() });
+                console.log(`Session created: ${id} (${sessions.size} active)`);
+            },
+        });
+        transport.onclose = () => {
+            const id = transport.sessionId;
+            if (id) {
+                sessions.delete(id);
+                console.log(`Session closed: ${id} (${sessions.size} active)`);
+            }
+        };
+        const server = createServer();
+        await server.connect(transport);
+        await transport.handleRequest(req, res, parsedBody);
+    });
+    httpServer.listen(PORT, "127.0.0.1", () => {
+        console.log(`DB-MCP Streamable HTTP server listening on port ${PORT}`);
+        console.log(`Endpoint: http://localhost:${PORT}/mcp`);
+    });
+}
+else {
+    // Local: stdio transport
+    const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
+    const server = createServer();
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}

package/build/slim.js

@@ -0,0 +1,139 @@
+/**
+ * Strips DB API responses down to the fields the LLM actually needs.
+ * Removes coordinates, operator details, ril100 IDs, excessive product info, etc.
+ * Also removes undefined/null values to minimize JSON size.
+ */
+/** JSON.stringify replacer that drops undefined/null values */
+function dropNulls(_key, value) {
+    return value === null || value === undefined ? undefined : value;
+}
+/** Compact JSON without pretty-printing, dropping nulls */
+export function compact(obj) {
+    return JSON.stringify(obj, dropNulls);
+}
+function pick(obj, keys) {
+    if (!obj)
+        return {};
+    const out = {};
+    for (const k of keys) {
+        if (obj[k] !== undefined && obj[k] !== null)
+            out[k] = obj[k];
+    }
+    return out;
+}
+function slimStop(stop) {
+    if (!stop)
+        return null;
+    return { id: stop.id, name: stop.name };
+}
+function slimRemarks(remarks) {
+    if (!Array.isArray(remarks))
+        return undefined;
+    const kept = remarks
+        .filter((r) => r.type === "warning" || r.type === "status")
+        .map((r) => pick(r, ["type", "summary", "text", "validFrom", "validUntil"]));
+    return kept.length > 0 ? kept : undefined;
+}
+function slimStopover(s) {
+    const out = { stop: s.stop?.name ?? null };
+    // Only include times that exist
+    const arr = s.arrival ?? s.plannedArrival;
+    if (arr)
+        out.arrival = arr;
+    if (s.arrivalDelay)
+        out.arrivalDelay = s.arrivalDelay;
+    const dep = s.departure ?? s.plannedDeparture;
+    if (dep)
+        out.departure = dep;
+    if (s.departureDelay)
+        out.departureDelay = s.departureDelay;
+    // Platform only if present
+    const plat = s.departurePlatform ?? s.plannedDeparturePlatform;
+    if (plat)
+        out.platform = plat;
+    if (s.cancelled)
+        out.cancelled = true;
+    return out;
+}
+// ── public API ───────────────────────────────────────────────────────
+function slimLeg(leg) {
+    const out = {
+        origin: slimStop(leg.origin),
+        destination: slimStop(leg.destination),
+        departure: leg.departure ?? leg.plannedDeparture,
+        plannedDeparture: leg.plannedDeparture,
+        departureDelay: leg.departureDelay ?? undefined,
+        arrival: leg.arrival ?? leg.plannedArrival,
+        plannedArrival: leg.plannedArrival,
+        arrivalDelay: leg.arrivalDelay ?? undefined,
+    };
+    if (leg.walking) {
+        out.walking = true;
+        if (leg.distance)
+            out.distance = leg.distance;
+    }
+    else {
+        out.line = leg.line ? pick(leg.line, ["name", "productName", "mode"]) : undefined;
+        out.direction = leg.direction;
+        out.departurePlatform = leg.departurePlatform ?? leg.plannedDeparturePlatform;
+        out.plannedDeparturePlatform = leg.plannedDeparturePlatform;
+        out.arrivalPlatform = leg.arrivalPlatform ?? leg.plannedArrivalPlatform;
+        out.plannedArrivalPlatform = leg.plannedArrivalPlatform;
+        if (leg.cancelled)
+            out.cancelled = true;
+        const remarks = slimRemarks(leg.remarks);
+        if (remarks)
+            out.remarks = remarks;
+        if (Array.isArray(leg.stopovers)) {
+            out.stopovers = leg.stopovers.map(slimStopover);
+        }
+    }
+    return out;
+}
+export function slimJourneys(data) {
+    const journeys = data.journeys ?? [];
+    return {
+        journeys: journeys.map((j) => ({
+            legs: (j.legs ?? []).map(slimLeg),
+            ...(j.price ? { price: j.price } : {}),
+        })),
+    };
+}
+export function slimTrip(data) {
+    const trip = data.trip ?? data;
+    return {
+        trip: {
+            ...pick(trip, ["id", "direction", "cancelled"]),
+            line: trip.line ? pick(trip.line, ["name", "productName", "mode"]) : undefined,
+            origin: slimStop(trip.origin),
+            destination: slimStop(trip.destination),
+            departure: trip.departure ?? trip.plannedDeparture,
+            plannedDeparture: trip.plannedDeparture,
+            departureDelay: trip.departureDelay ?? undefined,
+            arrival: trip.arrival ?? trip.plannedArrival,
+            plannedArrival: trip.plannedArrival,
+            arrivalDelay: trip.arrivalDelay ?? undefined,
+            remarks: slimRemarks(trip.remarks),
+            stopovers: Array.isArray(trip.stopovers)
+                ? trip.stopovers.map(slimStopover)
+                : undefined,
+        },
+    };
+}
+export function slimDeparture(d) {
+    return {
+        tripId: d.tripId,
+        line: d.line ? pick(d.line, ["name", "productName", "mode"]) : undefined,
+        direction: d.direction,
+        when: d.when ?? d.plannedWhen,
+        plannedWhen: d.plannedWhen,
+        delay: d.delay ?? undefined,
+        platform: d.platform ?? d.plannedPlatform,
+        plannedPlatform: d.plannedPlatform,
+        ...(d.cancelled ? { cancelled: true } : {}),
+        remarks: slimRemarks(d.remarks),
+    };
+}
+export function slimDepartures(departures) {
+    return departures.map((d) => slimDeparture(d));
+}

package/build/tools/find-journeys.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { client } from "../api-client.js";
+import { slimJourneys, compact } from "../slim.js";
+export function registerFindJourneys(server) {
+    server.tool("find_journeys", "Find journey connections between two stations. Returns journeys with legs, lines, platforms, stopovers, and remarks.", {
+        from_id: z.string().describe("Departure station ID (e.g. '8000261' for München Hbf)"),
+        to_id: z.string().describe("Arrival station ID (e.g. '8000105' for Frankfurt Hbf)"),
+        departure: z.string().describe("ISO departure date/time (e.g. '2026-03-08T14:00')"),
+        results: z.number().default(4).describe("Number of journeys to return (default 4)"),
+    }, async ({ from_id, to_id, departure, results }) => {
+        try {
+            for (const [label, id] of [["from_id", from_id], ["to_id", to_id]]) {
+                if (!/^\d{6,9}$/.test(id)) {
+                    return {
+                        isError: true,
+                        content: [{ type: "text", text: `find_journeys failed: Invalid ${label} '${id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
+                    };
+                }
+            }
+            const data = await client.journeys(from_id, to_id, {
+                departure: new Date(departure),
+                results,
+                stopovers: true,
+                remarks: true,
+            });
+            const slim = slimJourneys(data);
+            return {
+                content: [{ type: "text", text: compact(slim) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `find_journeys failed: ${error instanceof Error ? error.message : String(error)}` }],
+            };
+        }
+    });
+}

package/build/tools/find-station.js

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { client } from "../api-client.js";
+export function registerFindStation(server) {
+    server.tool("find_station", "Search for a Deutsche Bahn station by name. Returns raw JSON array of matching locations.", {
+        query: z.string().describe("Station name to search for"),
+        results: z
+            .number()
+            .default(1)
+            .describe("Number of results to return (default 1)"),
+    }, async ({ query, results }) => {
+        try {
+            const data = await client.locations(query, { results });
+            return {
+                content: [{ type: "text", text: JSON.stringify(data, null, 2) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `find_station failed: ${error instanceof Error ? error.message : String(error)}` }],
+            };
+        }
+    });
+}

package/build/tools/find-trip.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+import { client } from "../api-client.js";
+import { slimTrip, compact } from "../slim.js";
+const PRODUCT_PREFIXES = {
+    nationalExpress: ["ICE", "TGV", "RJ", "RJX", "ECE"],
+    national: ["IC", "EC", "EN", "NJ", "FLX"],
+    regionalExpress: ["RE", "IRE", "MEX", "FEX"],
+    regional: ["RB", "RS"],
+    suburban: ["S"],
+};
+function getProductFilters(trainName) {
+    const prefix = trainName.replace(/\s+/g, "").replace(/\d+$/, "").toUpperCase();
+    for (const [product, prefixes] of Object.entries(PRODUCT_PREFIXES)) {
+        if (prefixes.includes(prefix)) {
+            const products = {
+                nationalExpress: false,
+                national: false,
+                regionalExpress: false,
+                regional: false,
+                suburban: false,
+                bus: false,
+                ferry: false,
+                subway: false,
+                tram: false,
+            };
+            products[product] = true;
+            return products;
+        }
+    }
+    // Unknown prefix — don't filter
+    return undefined;
+}
+export function registerFindTrip(server) {
+    server.tool("find_trip", "Find a specific train trip by name and station. Fetches all departures for the day, matches the train, then retrieves full trip details with stopovers and remarks.", {
+        train_name: z.string().describe("Train name to search for (e.g. 'ICE 599')"),
+        station_id: z.string().describe("Station ID (e.g. '8000261' for München Hbf)"),
+        date: z.string().describe("ISO date string (e.g. '2026-03-08')"),
+    }, async ({ train_name, station_id, date }) => {
+        try {
+            if (!/^\d{6,9}$/.test(station_id)) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `find_trip failed: Invalid station_id '${station_id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
+                };
+            }
+            // Step 1: Get departures for the day (db profile max 720 min, so split into two 12h windows)
+            const products = getProductFilters(train_name);
+            const baseOpt = { duration: 720 };
+            if (products)
+                baseOpt.products = products;
+            const res1 = await client.departures(station_id, {
+                ...baseOpt,
+                when: new Date(`${date}T00:00`),
+            });
+            let departures = (res1.departures ?? []);
+            // Search second half of day if needed
+            const normalize = (s) => s.toLowerCase().replace(/\s+/g, "");
+            let match = departures.find((d) => d.line?.name != null &&
+                normalize(d.line.name) === normalize(train_name));
+            if (!match) {
+                const res2 = await client.departures(station_id, {
+                    ...baseOpt,
+                    when: new Date(`${date}T12:00`),
+                });
+                const moreDepartures = (res2.departures ?? []);
+                departures = [...departures, ...moreDepartures];
+                match = moreDepartures.find((d) => d.line?.name != null &&
+                    normalize(d.line.name) === normalize(train_name));
+            }
+            if (!match || !match.tripId) {
+                const availableNames = [
+                    ...new Set(departures
+                        .map((d) => d.line?.name)
+                        .filter((n) => !!n)),
+                ];
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: JSON.stringify({
+                                error: `No departure found matching '${train_name}' at station ${station_id} on ${date}`,
+                                available_trains: availableNames,
+                            }, null, 2),
+                        },
+                    ],
+                };
+            }
+            // Step 2: Fetch full trip details
+            const trip = await client.trip(match.tripId, match.line?.name ?? "", {
+                stopovers: true,
+                remarks: true,
+            });
+            const slim = slimTrip(trip);
+            return {
+                content: [{ type: "text", text: compact(slim) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `find_trip failed: ${error instanceof Error ? error.message : String(error)}` }],
+            };
+        }
+    });
+}

package/build/tools/get-departures.js

@@ -0,0 +1,39 @@
+import { z } from "zod";
+import { client } from "../api-client.js";
+import { slimDepartures, compact } from "../slim.js";
+export function registerGetDepartures(server) {
+    server.tool("get_departures", "Get upcoming departures from a Deutsche Bahn station. Returns raw JSON array of departures with line.name, direction, when, delay, platform, remarks.", {
+        station_id: z.string().describe("Station ID (e.g. '8000261' for München Hbf)"),
+        when: z
+            .string()
+            .optional()
+            .describe("ISO 8601 datetime string (optional, defaults to now)"),
+        duration: z
+            .number()
+            .default(60)
+            .describe("Duration in minutes to query (default 60)"),
+    }, async ({ station_id, when, duration }) => {
+        try {
+            if (!/^\d{6,9}$/.test(station_id)) {
+                return {
+                    isError: true,
+                    content: [{ type: "text", text: `get_departures failed: Invalid station_id '${station_id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
+                };
+            }
+            const opt = { duration };
+            if (when)
+                opt.when = new Date(when);
+            const res = await client.departures(station_id, opt);
+            const slim = slimDepartures((res.departures ?? []));
+            return {
+                content: [{ type: "text", text: compact(slim) }],
+            };
+        }
+        catch (error) {
+            return {
+                isError: true,
+                content: [{ type: "text", text: `get_departures failed: ${error instanceof Error ? error.message : String(error)}` }],
+            };
+        }
+    });
+}

package/package.json

@@ -1 +1 @@
-{"name": "@iflow-mcp/faaak2-db-mcp", "version": "1.0.2", "type": "module", "bin": {"iflow-mcp_faaak2-db-mcp": "cli.js"}, "scripts": {"build": "tsc", "start": "node build/index.js", "serve": "PORT=3000 node build/index.js"}, "dependencies": {"@modelcontextprotocol/sdk": "^1.11.0", "db-vendo-client": "^6.10.8", "zod": "^3.24.0"}, "devDependencies": {"@types/node": "^22.0.0", "typescript": "^5.7.0"}}
+{"name": "@iflow-mcp/faaak2-db-mcp", "version": "1.0.3", "type": "module", "bin": {"iflow-mcp_faaak2-db-mcp": "cli.js"}, "files": ["build", "cli.js", "package.json"], "scripts": {"build": "tsc", "start": "node build/index.js", "serve": "PORT=3000 node build/index.js"}, "dependencies": {"@modelcontextprotocol/sdk": "^1.11.0", "db-vendo-client": "^6.10.8", "zod": "^3.24.0"}, "devDependencies": {"@types/node": "^22.0.0", "typescript": "^5.7.0"}}

package/.mcp.json

@@ -1,8 +0,0 @@
-{
-  "mcpServers": {
-    "db-mcp": {
-      "type": "http",
-      "url": "https://mcp-builder.de/db/mcp"
-    }
-  }
-}

package/24918_process.log

@@ -1,14 +0,0 @@
-[2026-03-17] 开始处理项目 mcp-db
-[2026-03-17] 步骤1完成：成功fork并克隆项目
-[2026-03-17] 步骤2完成：代码阅读和类型判断
-  - 项目类型：Node.js（TypeScript）
-  - 支持协议：stdio, Streamable HTTP
-  - 工具数量：4个
-  - 符合npm合规政策
-[2026-03-17] 步骤3完成：本地测试
-  - 修改package.json：name改为@iflow-mcp/faaak2-db-mcp，添加bin字段
-  - 构建成功
-  - 本地测试通过，检测到4个工具：find_station, get_departures, find_trip, find_journeys
-[2026-03-17] 步骤4完成：成功创建并推送iflow分支
-[2026-03-17] 步骤5完成：成功上传到npm官方仓库
-[2026-03-17] 步骤6开始：生成ServerConfig并测试

package/CLAUDE.md

@@ -1,51 +0,0 @@
-## Scope Rule
-- Thorough inside the task boundary, hands-off outside it
-- Within scope: find root causes, don't patch symptoms
-- Outside scope: don't touch it, even if it's ugly
-
-## Plan Mode
-- Use plan mode when there are multiple valid approaches or architectural decisions
-- If something goes sideways, STOP and re-plan — don't keep pushing
-- Skip plan mode when the path is obvious, even if many steps
-
-## Self-Improvement Loop
-- After ANY correction, update auto-memory (MEMORY.md or topic files)
-- Write rules that prevent the same mistake recurring
-- Keep MEMORY.md as concise index, use topic files for details
-
-## Verification
-- Never mark a task complete without proving it works
-- Run tests, check logs, demonstrate correctness
-- "Would a staff engineer approve this?"
-
-## Bug Fixing
-- When given a bug: fix it autonomously
-- Follow logs and errors to root cause, then resolve
-
-## Deployment
-
-### Production (mcp-builder.de)
-- **URL:** `https://mcp-builder.de/db/mcp`
-- **Health:** `GET /` → `{"status":"ok","name":"db-mcp"}`
-- **Transport:** Streamable HTTP (MCP Spec 2025-03-26)
-- **Hosting:** Systemd service behind Caddy reverse proxy
-
-### Transport-Logik (`src/index.ts`)
-- `PORT` env var gesetzt → Streamable HTTP
-- Kein `PORT` → stdio (lokale Nutzung via Claude Desktop/Claude Code)
-
-### MCP-Client Konfiguration (Remote)
-```json
-{
-  "mcpServers": {
-    "db-mcp": {
-      "url": "https://mcp-builder.de/db/mcp"
-    }
-  }
-}
-```
-
-### Lokaler Test HTTP-Modus
-```bash
-npm run serve   # startet auf PORT=3000
-```

package/language.json

@@ -1 +0,0 @@
-nodejs

package/package_name

@@ -1 +0,0 @@
-@iflow-mcp/faaak2-db-mcp

package/push_info.json

@@ -1,5 +0,0 @@
-{
-  "push_platform": "github",
-  "fork_url": "https://github.com/iflow-mcp/faaak2-mcp-db",
-  "fork_branch": "iflow"
-}

package/server_config.json

@@ -1 +0,0 @@
-{"serverConfig": "{\"mcpServers\":{\"db-mcp\":{\"command\":\"npx\",\"args\":[\"-y\",\"-p\",\"node\",\"node\",\"-e\",\"import process from 'process';const {exec}=await import('child_process');const p=exec('npx -y @iflow-mcp/faaak2-db-mcp@latest');p.stdout.pipe(process.stdout);p.stderr.pipe(process.stderr);p.on('close',c=>process.exit(c))\"],\"values\":{}}}}"}

package/src/db-vendo-client.d.ts

@@ -1,34 +0,0 @@
-declare module "db-vendo-client" {
-  interface ClientOptions {
-    when?: Date;
-    duration?: number;
-    products?: Record<string, boolean>;
-    results?: number;
-    stopovers?: boolean;
-    remarks?: boolean;
-    departure?: Date;
-    arrival?: Date;
-    transfers?: number;
-    transferTime?: number;
-    language?: string;
-    polyline?: boolean;
-    [key: string]: unknown;
-  }
-
-  interface Client {
-    locations(query: string, opt?: ClientOptions): Promise<unknown[]>;
-    departures(station: string, opt?: ClientOptions): Promise<{ departures: unknown[]; realtimeDataUpdatedAt?: number }>;
-    arrivals(station: string, opt?: ClientOptions): Promise<{ arrivals: unknown[]; realtimeDataUpdatedAt?: number }>;
-    journeys(from: string, to: string, opt?: ClientOptions): Promise<{ journeys: unknown[]; earlierRef?: string; laterRef?: string; realtimeDataUpdatedAt?: number }>;
-    trip(id: string, lineName: string, opt?: ClientOptions): Promise<unknown>;
-    stop(id: string, opt?: ClientOptions): Promise<unknown>;
-    nearby(location: { latitude: number; longitude: number }, opt?: ClientOptions): Promise<unknown[]>;
-    refreshJourney(refreshToken: string, opt?: ClientOptions): Promise<unknown>;
-  }
-
-  export function createClient(profile: unknown, userAgent: string): Client;
-}
-
-declare module "db-vendo-client/p/db/index.js" {
-  export const profile: unknown;
-}

package/src/index.ts

@@ -1,135 +0,0 @@
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { instructions } from "./instructions.js";
-import { registerFindStation } from "./tools/find-station.js";
-import { registerGetDepartures } from "./tools/get-departures.js";
-import { registerFindTrip } from "./tools/find-trip.js";
-import { registerFindJourneys } from "./tools/find-journeys.js";
-
-function createServer(): McpServer {
-  const server = new McpServer(
-    { name: "db-mcp", version: "1.0.0" },
-    { instructions },
-  );
-  registerFindStation(server);
-  registerGetDepartures(server);
-  registerFindTrip(server);
-  registerFindJourneys(server);
-  return server;
-}
-
-if (process.env.PORT) {
-  // Remote: Streamable HTTP transport
-  const { createServer: createHttpServer } = await import("node:http");
-  const { StreamableHTTPServerTransport } = await import(
-    "@modelcontextprotocol/sdk/server/streamableHttp.js"
-  );
-
-  const PORT = parseInt(process.env.PORT, 10);
-  const sessions = new Map<
-    string,
-    { server: McpServer; transport: InstanceType<typeof StreamableHTTPServerTransport>; createdAt: number }
-  >();
-
-  // Session timeout: clean up sessions after 30 min
-  const SESSION_TIMEOUT_MS = 30 * 60 * 1000;
-
-  setInterval(() => {
-    const now = Date.now();
-    for (const [id, session] of sessions) {
-      if (now - session.createdAt > SESSION_TIMEOUT_MS) {
-        session.transport.close?.();
-        sessions.delete(id);
-        console.log(`Session expired: ${id} (${sessions.size} active)`);
-      }
-    }
-  }, 60_000);
-
-  const httpServer = createHttpServer(async (req, res) => {
-    const url = new URL(req.url || "/", `http://localhost:${PORT}`);
-
-    // Health check for Railway
-    if (url.pathname === "/" && req.method === "GET") {
-      res.writeHead(200, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ status: "ok", name: "db-mcp" }));
-      return;
-    }
-
-    if (url.pathname !== "/mcp") {
-      res.writeHead(404, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ error: "Not found. Use POST /mcp" }));
-      return;
-    }
-
-    // CORS
-    res.setHeader("Access-Control-Allow-Origin", "https://mcp-builder.de");
-    res.setHeader("Access-Control-Allow-Methods", "GET, POST, DELETE, OPTIONS");
-    res.setHeader("Access-Control-Allow-Headers", "Content-Type, mcp-session-id");
-    res.setHeader("Access-Control-Expose-Headers", "mcp-session-id");
-
-    if (req.method === "OPTIONS") {
-      res.writeHead(204);
-      res.end();
-      return;
-    }
-
-    // Parse body for POST
-    let parsedBody: unknown = undefined;
-    if (req.method === "POST") {
-      const chunks: Buffer[] = [];
-      for await (const chunk of req) {
-        chunks.push(typeof chunk === "string" ? Buffer.from(chunk) : chunk);
-      }
-      parsedBody = JSON.parse(Buffer.concat(chunks).toString());
-    }
-
-    // Route by session
-    const sessionId = req.headers["mcp-session-id"] as string | undefined;
-
-    if (sessionId && sessions.has(sessionId)) {
-      const session = sessions.get(sessionId)!;
-      await session.transport.handleRequest(req, res, parsedBody);
-      return;
-    }
-
-    if (sessionId && !sessions.has(sessionId)) {
-      // Session expired or lost (e.g. after redeploy) — tell client to re-initialize
-      res.writeHead(404, { "Content-Type": "application/json" });
-      res.end(JSON.stringify({ error: "Session not found. Please start a new session." }));
-      return;
-    }
-
-    // New session
-    const transport = new StreamableHTTPServerTransport({
-      sessionIdGenerator: () => crypto.randomUUID(),
-      onsessioninitialized: (id) => {
-        sessions.set(id, { server, transport, createdAt: Date.now() });
-        console.log(`Session created: ${id} (${sessions.size} active)`);
-      },
-    });
-
-    transport.onclose = () => {
-      const id = transport.sessionId;
-      if (id) {
-        sessions.delete(id);
-        console.log(`Session closed: ${id} (${sessions.size} active)`);
-      }
-    };
-
-    const server = createServer();
-    await server.connect(transport);
-    await transport.handleRequest(req, res, parsedBody);
-  });
-
-  httpServer.listen(PORT, "127.0.0.1", () => {
-    console.log(`DB-MCP Streamable HTTP server listening on port ${PORT}`);
-    console.log(`Endpoint: http://localhost:${PORT}/mcp`);
-  });
-} else {
-  // Local: stdio transport
-  const { StdioServerTransport } = await import(
-    "@modelcontextprotocol/sdk/server/stdio.js"
-  );
-  const server = createServer();
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}

package/src/slim.ts

@@ -1,148 +0,0 @@
-/**
- * Strips DB API responses down to the fields the LLM actually needs.
- * Removes coordinates, operator details, ril100 IDs, excessive product info, etc.
- * Also removes undefined/null values to minimize JSON size.
- */
-
-// ── helpers ──────────────────────────────────────────────────────────
-
-interface AnyObj {
-  [key: string]: unknown;
-}
-
-/** JSON.stringify replacer that drops undefined/null values */
-function dropNulls(_key: string, value: unknown): unknown {
-  return value === null || value === undefined ? undefined : value;
-}
-
-/** Compact JSON without pretty-printing, dropping nulls */
-export function compact(obj: unknown): string {
-  return JSON.stringify(obj, dropNulls);
-}
-
-function pick<T extends AnyObj>(obj: T | undefined | null, keys: string[]): AnyObj {
-  if (!obj) return {};
-  const out: AnyObj = {};
-  for (const k of keys) {
-    if (obj[k] !== undefined && obj[k] !== null) out[k] = obj[k];
-  }
-  return out;
-}
-
-function slimStop(stop: AnyObj | undefined | null): AnyObj | null {
-  if (!stop) return null;
-  return { id: stop.id, name: stop.name };
-}
-
-function slimRemarks(remarks: unknown): AnyObj[] | undefined {
-  if (!Array.isArray(remarks)) return undefined;
-  const kept = remarks
-    .filter((r: AnyObj) => r.type === "warning" || r.type === "status")
-    .map((r: AnyObj) => pick(r, ["type", "summary", "text", "validFrom", "validUntil"]));
-  return kept.length > 0 ? kept : undefined;
-}
-
-function slimStopover(s: AnyObj): AnyObj {
-  const out: AnyObj = { stop: (s.stop as AnyObj)?.name ?? null };
-  // Only include times that exist
-  const arr = s.arrival ?? s.plannedArrival;
-  if (arr) out.arrival = arr;
-  if (s.arrivalDelay) out.arrivalDelay = s.arrivalDelay;
-  const dep = s.departure ?? s.plannedDeparture;
-  if (dep) out.departure = dep;
-  if (s.departureDelay) out.departureDelay = s.departureDelay;
-  // Platform only if present
-  const plat = s.departurePlatform ?? s.plannedDeparturePlatform;
-  if (plat) out.platform = plat;
-  if (s.cancelled) out.cancelled = true;
-  return out;
-}
-
-// ── public API ───────────────────────────────────────────────────────
-
-function slimLeg(leg: AnyObj): AnyObj {
-  const out: AnyObj = {
-    origin: slimStop(leg.origin as AnyObj),
-    destination: slimStop(leg.destination as AnyObj),
-    departure: leg.departure ?? leg.plannedDeparture,
-    plannedDeparture: leg.plannedDeparture,
-    departureDelay: leg.departureDelay ?? undefined,
-    arrival: leg.arrival ?? leg.plannedArrival,
-    plannedArrival: leg.plannedArrival,
-    arrivalDelay: leg.arrivalDelay ?? undefined,
-  };
-
-  if (leg.walking) {
-    out.walking = true;
-    if (leg.distance) out.distance = leg.distance;
-  } else {
-    out.line = leg.line ? pick(leg.line as AnyObj, ["name", "productName", "mode"]) : undefined;
-    out.direction = leg.direction;
-    out.departurePlatform = leg.departurePlatform ?? leg.plannedDeparturePlatform;
-    out.plannedDeparturePlatform = leg.plannedDeparturePlatform;
-    out.arrivalPlatform = leg.arrivalPlatform ?? leg.plannedArrivalPlatform;
-    out.plannedArrivalPlatform = leg.plannedArrivalPlatform;
-
-    if (leg.cancelled) out.cancelled = true;
-
-    const remarks = slimRemarks(leg.remarks);
-    if (remarks) out.remarks = remarks;
-
-    if (Array.isArray(leg.stopovers)) {
-      out.stopovers = (leg.stopovers as AnyObj[]).map(slimStopover);
-    }
-  }
-
-  return out;
-}
-
-export function slimJourneys(data: AnyObj): AnyObj {
-  const journeys = (data.journeys as AnyObj[]) ?? [];
-  return {
-    journeys: journeys.map((j) => ({
-      legs: ((j.legs as AnyObj[]) ?? []).map(slimLeg),
-      ...(j.price ? { price: j.price } : {}),
-    })),
-  };
-}
-
-export function slimTrip(data: AnyObj): AnyObj {
-  const trip = (data.trip as AnyObj) ?? data;
-  return {
-    trip: {
-      ...pick(trip, ["id", "direction", "cancelled"]),
-      line: trip.line ? pick(trip.line as AnyObj, ["name", "productName", "mode"]) : undefined,
-      origin: slimStop(trip.origin as AnyObj),
-      destination: slimStop(trip.destination as AnyObj),
-      departure: trip.departure ?? trip.plannedDeparture,
-      plannedDeparture: trip.plannedDeparture,
-      departureDelay: trip.departureDelay ?? undefined,
-      arrival: trip.arrival ?? trip.plannedArrival,
-      plannedArrival: trip.plannedArrival,
-      arrivalDelay: trip.arrivalDelay ?? undefined,
-      remarks: slimRemarks(trip.remarks),
-      stopovers: Array.isArray(trip.stopovers)
-        ? (trip.stopovers as AnyObj[]).map(slimStopover)
-        : undefined,
-    },
-  };
-}
-
-export function slimDeparture(d: AnyObj): AnyObj {
-  return {
-    tripId: d.tripId,
-    line: d.line ? pick(d.line as AnyObj, ["name", "productName", "mode"]) : undefined,
-    direction: d.direction,
-    when: d.when ?? d.plannedWhen,
-    plannedWhen: d.plannedWhen,
-    delay: d.delay ?? undefined,
-    platform: d.platform ?? d.plannedPlatform,
-    plannedPlatform: d.plannedPlatform,
-    ...(d.cancelled ? { cancelled: true } : {}),
-    remarks: slimRemarks(d.remarks),
-  };
-}
-
-export function slimDepartures(departures: unknown[]): AnyObj[] {
-  return departures.map((d) => slimDeparture(d as AnyObj));
-}

package/src/tools/find-journeys.ts

@@ -1,46 +0,0 @@
-import { z } from "zod";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { client } from "../api-client.js";
-import { slimJourneys, compact } from "../slim.js";
-
-export function registerFindJourneys(server: McpServer) {
-  server.tool(
-    "find_journeys",
-    "Find journey connections between two stations. Returns journeys with legs, lines, platforms, stopovers, and remarks.",
-    {
-      from_id: z.string().describe("Departure station ID (e.g. '8000261' for München Hbf)"),
-      to_id: z.string().describe("Arrival station ID (e.g. '8000105' for Frankfurt Hbf)"),
-      departure: z.string().describe("ISO departure date/time (e.g. '2026-03-08T14:00')"),
-      results: z.number().default(4).describe("Number of journeys to return (default 4)"),
-    },
-    async ({ from_id, to_id, departure, results }) => {
-      try {
-        for (const [label, id] of [["from_id", from_id], ["to_id", to_id]] as const) {
-          if (!/^\d{6,9}$/.test(id)) {
-            return {
-              isError: true,
-              content: [{ type: "text" as const, text: `find_journeys failed: Invalid ${label} '${id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
-            };
-          }
-        }
-
-        const data = await client.journeys(from_id, to_id, {
-          departure: new Date(departure),
-          results,
-          stopovers: true,
-          remarks: true,
-        });
-
-        const slim = slimJourneys(data as Record<string, unknown>);
-        return {
-          content: [{ type: "text" as const, text: compact(slim) }],
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [{ type: "text" as const, text: `find_journeys failed: ${error instanceof Error ? error.message : String(error)}` }],
-        };
-      }
-    },
-  );
-}

package/src/tools/find-station.ts

@@ -1,31 +0,0 @@
-import { z } from "zod";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { client } from "../api-client.js";
-
-export function registerFindStation(server: McpServer) {
-  server.tool(
-    "find_station",
-    "Search for a Deutsche Bahn station by name. Returns raw JSON array of matching locations.",
-    {
-      query: z.string().describe("Station name to search for"),
-      results: z
-        .number()
-        .default(1)
-        .describe("Number of results to return (default 1)"),
-    },
-    async ({ query, results }) => {
-      try {
-        const data = await client.locations(query, { results });
-
-        return {
-          content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }],
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [{ type: "text" as const, text: `find_station failed: ${error instanceof Error ? error.message : String(error)}` }],
-        };
-      }
-    },
-  );
-}

package/src/tools/find-trip.ts

@@ -1,140 +0,0 @@
-import { z } from "zod";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { client } from "../api-client.js";
-import { slimTrip, compact } from "../slim.js";
-
-interface Departure {
-  tripId?: string;
-  line?: { name?: string };
-  [key: string]: unknown;
-}
-
-const PRODUCT_PREFIXES: Record<string, string[]> = {
-  nationalExpress: ["ICE", "TGV", "RJ", "RJX", "ECE"],
-  national: ["IC", "EC", "EN", "NJ", "FLX"],
-  regionalExpress: ["RE", "IRE", "MEX", "FEX"],
-  regional: ["RB", "RS"],
-  suburban: ["S"],
-};
-
-function getProductFilters(trainName: string): Record<string, boolean> | undefined {
-  const prefix = trainName.replace(/\s+/g, "").replace(/\d+$/, "").toUpperCase();
-
-  for (const [product, prefixes] of Object.entries(PRODUCT_PREFIXES)) {
-    if (prefixes.includes(prefix)) {
-      const products: Record<string, boolean> = {
-        nationalExpress: false,
-        national: false,
-        regionalExpress: false,
-        regional: false,
-        suburban: false,
-        bus: false,
-        ferry: false,
-        subway: false,
-        tram: false,
-      };
-      products[product] = true;
-      return products;
-    }
-  }
-
-  // Unknown prefix — don't filter
-  return undefined;
-}
-
-export function registerFindTrip(server: McpServer) {
-  server.tool(
-    "find_trip",
-    "Find a specific train trip by name and station. Fetches all departures for the day, matches the train, then retrieves full trip details with stopovers and remarks.",
-    {
-      train_name: z.string().describe("Train name to search for (e.g. 'ICE 599')"),
-      station_id: z.string().describe("Station ID (e.g. '8000261' for München Hbf)"),
-      date: z.string().describe("ISO date string (e.g. '2026-03-08')"),
-    },
-    async ({ train_name, station_id, date }) => {
-      try {
-        if (!/^\d{6,9}$/.test(station_id)) {
-          return {
-            isError: true,
-            content: [{ type: "text" as const, text: `find_trip failed: Invalid station_id '${station_id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
-          };
-        }
-
-        // Step 1: Get departures for the day (db profile max 720 min, so split into two 12h windows)
-        const products = getProductFilters(train_name);
-        const baseOpt: Record<string, unknown> = { duration: 720 };
-        if (products) baseOpt.products = products;
-
-        const res1 = await client.departures(station_id, {
-          ...baseOpt,
-          when: new Date(`${date}T00:00`),
-        });
-        let departures: Departure[] = (res1.departures ?? []) as Departure[];
-
-        // Search second half of day if needed
-        const normalize = (s: string) => s.toLowerCase().replace(/\s+/g, "");
-        let match = departures.find(
-          (d) =>
-            d.line?.name != null &&
-            normalize(d.line.name) === normalize(train_name),
-        );
-
-        if (!match) {
-          const res2 = await client.departures(station_id, {
-            ...baseOpt,
-            when: new Date(`${date}T12:00`),
-          });
-          const moreDepartures = (res2.departures ?? []) as Departure[];
-          departures = [...departures, ...moreDepartures];
-
-          match = moreDepartures.find(
-            (d) =>
-              d.line?.name != null &&
-              normalize(d.line.name) === normalize(train_name),
-          );
-        }
-
-        if (!match || !match.tripId) {
-          const availableNames = [
-            ...new Set(
-              departures
-                .map((d) => d.line?.name)
-                .filter((n): n is string => !!n),
-            ),
-          ];
-          return {
-            content: [
-              {
-                type: "text" as const,
-                text: JSON.stringify(
-                  {
-                    error: `No departure found matching '${train_name}' at station ${station_id} on ${date}`,
-                    available_trains: availableNames,
-                  },
-                  null,
-                  2,
-                ),
-              },
-            ],
-          };
-        }
-
-        // Step 2: Fetch full trip details
-        const trip = await client.trip(match.tripId, match.line?.name ?? "", {
-          stopovers: true,
-          remarks: true,
-        });
-
-        const slim = slimTrip(trip as Record<string, unknown>);
-        return {
-          content: [{ type: "text" as const, text: compact(slim) }],
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [{ type: "text" as const, text: `find_trip failed: ${error instanceof Error ? error.message : String(error)}` }],
-        };
-      }
-    },
-  );
-}

package/src/tools/get-departures.ts

@@ -1,47 +0,0 @@
-import { z } from "zod";
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { client } from "../api-client.js";
-import { slimDepartures, compact } from "../slim.js";
-
-export function registerGetDepartures(server: McpServer) {
-  server.tool(
-    "get_departures",
-    "Get upcoming departures from a Deutsche Bahn station. Returns raw JSON array of departures with line.name, direction, when, delay, platform, remarks.",
-    {
-      station_id: z.string().describe("Station ID (e.g. '8000261' for München Hbf)"),
-      when: z
-        .string()
-        .optional()
-        .describe("ISO 8601 datetime string (optional, defaults to now)"),
-      duration: z
-        .number()
-        .default(60)
-        .describe("Duration in minutes to query (default 60)"),
-    },
-    async ({ station_id, when, duration }) => {
-      try {
-        if (!/^\d{6,9}$/.test(station_id)) {
-          return {
-            isError: true,
-            content: [{ type: "text" as const, text: `get_departures failed: Invalid station_id '${station_id}'. Expected a numeric HAFAS ID (e.g. '8000261' for München Hbf). Use find_station to look up the correct ID.` }],
-          };
-        }
-
-        const opt: Record<string, unknown> = { duration };
-        if (when) opt.when = new Date(when);
-
-        const res = await client.departures(station_id, opt);
-
-        const slim = slimDepartures((res.departures ?? []) as Record<string, unknown>[]);
-        return {
-          content: [{ type: "text" as const, text: compact(slim) }],
-        };
-      } catch (error) {
-        return {
-          isError: true,
-          content: [{ type: "text" as const, text: `get_departures failed: ${error instanceof Error ? error.message : String(error)}` }],
-        };
-      }
-    },
-  );
-}

package/tsconfig.json

@@ -1,13 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "Node16",
-    "moduleResolution": "Node16",
-    "strict": true,
-    "outDir": "./build",
-    "rootDir": "./src",
-    "esModuleInterop": true,
-    "skipLibCheck": true
-  },
-  "include": ["src"]
-}