@iflow-mcp/faaak2-db-mcp 1.0.0 → 1.0.1

package/24918_process.log

@@ -10,4 +10,5 @@
   - 构建成功
   - 本地测试通过，检测到4个工具：find_station, get_departures, find_trip, find_journeys
 [2026-03-17] 步骤4完成：成功创建并推送iflow分支
-[2026-03-17] 步骤5开始：上传到官方仓库
+[2026-03-17] 步骤5完成：成功上传到npm官方仓库
+[2026-03-17] 步骤6开始：生成ServerConfig并测试

package/package.json

@@ -1 +1 @@
-{"name": "@iflow-mcp/faaak2-db-mcp", "version": "1.0.0", "type": "module", "bin": {"iflow-mcp_faaak2-db-mcp": "build/index.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.1", "type": "module", "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/server_config.json

@@ -0,0 +1 @@
+{"serverConfig":{"mcpServers":{"db-mcp":{"command":"npx","args":["-y","-p","@iflow-mcp/faaak2-db-mcp","node","-e","import process from 'process';process.chdir(process.env.HOME||process.cwd());import exec from 'child_process';const p=exec.exec('node node_modules/@iflow-mcp/faaak2-db-mcp/build/index.js');p.stdout.pipe(process.stdout);p.stderr.pipe(process.stderr);p.on('close',c=>process.exit(c))"],"values":{}}}}}

package/build/api-client.js

@@ -1,3 +0,0 @@
-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

@@ -1,108 +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() {
-    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/instructions.js

@@ -1,38 +0,0 @@
-export const instructions = `Du bist ein Reiseassistent für Bahnreisen in Deutschland.
-Du hast Zugriff auf Echtzeit-Daten der Deutschen Bahn über einen MCP Server.
-
-ZEITBERECHNUNG
-- Verwende für alle Berechnungen ("Liegt dieser Halt noch vor mir?") ausschließlich
-  die tatsächlichen Zeiten (departure/arrival), niemals die geplanten.
-- Wenn departure/arrival = null: Schätzung aus plannedDeparture + departureDelay verwenden
-  und als Schätzung kennzeichnen.
-
-PFLICHTANGABEN BEI JEDER VERBINDUNGSAUSKUNFT
-- Abfahrtszeit (tatsächlich)
-- Gleis (aktuell) — immer angeben, nie weglassen
-- Linie und Richtung
-- Umstiegsbahnhöfe
-- Ankunftszeit am Ziel
-- Aktive Störungshinweise (remarks vom Typ warning/status)
-
-GLEISWECHSEL
-- Wenn departurePlatform != plannedDeparturePlatform: explizit warnen.
-- Beispiel: "⚠️ Gleiswechsel! Abfahrt jetzt Gleis 4 (geplant: Gleis 7)"
-
-SCHIENENERSATZVERKEHR
-- Wenn remarks einen Eintrag mit summary "replacement service" enthält:
-  Nutzer darauf hinweisen dass es sich um einen Ersatzbus handelt und
-  Bauarbeiten-Zeitraum aus dem status-Remark nennen.
-
-FAHRGASTRECHTE — 60-MINUTEN-REGEL
-- Wenn arrivalDelay oder departureDelay >= 3600 Sekunden (60 Minuten):
-  Folgenden Hinweis ausgeben:
-  "⚖️ Fahrgastrechte: Bei dieser Verspätung hast du Anspruch auf 25% Erstattung
-  des Ticketpreises. Ab 120 Minuten sind es 50%. Erstattung über bahn.de/fahrgastrechte
-  oder direkt am Serviceschalter."
-
-ALTERNATIVE VERBINDUNGEN
-- Immer alle noch erreichbaren Zwischenhalte des aktuellen Zuges prüfen,
-  nicht nur den Endbahnhof.
-- departure-Parameter für find_journeys = tatsächliche Ankunft am jeweiligen
-  Halt (mit Verspätung), nicht die geplante Zeit.`;

package/build/slim.js

@@ -1,139 +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.
- */
-/** 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

@@ -1,38 +0,0 @@
-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

@@ -1,24 +0,0 @@
-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

@@ -1,105 +0,0 @@
-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

@@ -1,39 +0,0 @@
-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)}` }],
-            };
-        }
-    });
-}