mcp-chrono 1.0.0

package/build/tools/calendar-convert.js.map

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

package/build/tools/countdown.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/build/tools/countdown.js

@@ -0,0 +1,38 @@
+import { z } from "zod";
+import { DateTime } from "luxon";
+export function register(server) {
+    server.tool("countdown", "Calculate a countdown from now to a target date/time. Returns remaining days, hours, minutes, seconds and whether the date is in the past.", {
+        target: z.string().describe("Target date/time in ISO 8601 format (e.g. 2024-12-31T23:59:59 or 2025-01-01)"),
+        timezone: z.string().optional().describe("IANA timezone for the target date. Defaults to UTC."),
+    }, async ({ target, timezone }) => {
+        const tz = timezone || "UTC";
+        const now = DateTime.now().setZone(tz);
+        const targetDt = DateTime.fromISO(target, { zone: tz });
+        if (!targetDt.isValid) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `Invalid target date: ${targetDt.invalidExplanation}` }) }] };
+        }
+        const isPast = targetDt < now;
+        const [earlier, later] = isPast ? [targetDt, now] : [now, targetDt];
+        const diff = later.diff(earlier, ["days", "hours", "minutes", "seconds"]);
+        const result = {
+            now: now.toISO(),
+            target: targetDt.toISO(),
+            timezone: tz,
+            isPast,
+            remaining: {
+                days: Math.floor(diff.days),
+                hours: Math.floor(diff.hours),
+                minutes: Math.floor(diff.minutes),
+                seconds: Math.floor(diff.seconds),
+            },
+            totalDays: Math.floor(diff.as("days")),
+            totalHours: Math.floor(diff.as("hours")),
+            totalSeconds: Math.floor(diff.as("seconds")),
+            summary: isPast
+                ? `${Math.floor(diff.as("days"))} days ago`
+                : `${Math.floor(diff.as("days"))} days remaining`,
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=countdown.js.map

package/build/tools/countdown.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"countdown.js","sourceRoot":"","sources":["../../src/tools/countdown.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,WAAW,EACX,4IAA4I,EAC5I;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;QAC3G,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,qDAAqD,CAAC;KAChG,EACD,KAAK,EAAE,EAAE,MAAM,EAAE,QAAQ,EAAE,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,QAAQ,IAAI,KAAK,CAAC;QAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;QAExD,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,wBAAwB,QAAQ,CAAC,kBAAkB,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;QACjI,CAAC;QAED,MAAM,MAAM,GAAG,QAAQ,GAAG,GAAG,CAAC;QAC9B,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;QACpE,MAAM,IAAI,GAAG,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;QAE1E,MAAM,MAAM,GAAG;YACb,GAAG,EAAE,GAAG,CAAC,KAAK,EAAE;YAChB,MAAM,EAAE,QAAQ,CAAC,KAAK,EAAE;YACxB,QAAQ,EAAE,EAAE;YACZ,MAAM;YACN,SAAS,EAAE;gBACT,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;gBAC3B,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC;gBAC7B,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;gBACjC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC;aAClC;YACD,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC;YACtC,UAAU,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC;YACxC,YAAY,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;YAC5C,OAAO,EAAE,MAAM;gBACb,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,WAAW;gBAC3C,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,iBAAiB;SACpD,CAAC;QAEF,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAChF,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/current-time.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/build/tools/current-time.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { DateTime } from "luxon";
+export function register(server) {
+    server.tool("get_current_time", "Get the current time in a specified timezone. Returns detailed time information including year, month, day, hour, minute, second, weekday, week of year, day of year, and UTC offset.", {
+        timezone: z.string().optional().describe("IANA timezone (e.g. Asia/Shanghai, America/New_York). Defaults to UTC."),
+        format: z.enum(["iso", "human", "relative"]).optional().describe("Output format: iso (default), human (readable), relative (time ago from UTC)"),
+    }, async ({ timezone, format }) => {
+        const tz = timezone || "UTC";
+        const now = DateTime.now().setZone(tz);
+        if (!now.isValid) {
+            return {
+                content: [{ type: "text", text: JSON.stringify({ error: `Invalid timezone: ${tz}` }) }],
+            };
+        }
+        const fmt = format || "iso";
+        const result = {
+            timezone: tz,
+            year: now.year,
+            month: now.month,
+            day: now.day,
+            hour: now.hour,
+            minute: now.minute,
+            second: now.second,
+            weekday: now.weekdayLong,
+            weekOfYear: now.weekNumber,
+            dayOfYear: now.ordinal,
+            utcOffset: now.toFormat("ZZ"),
+        };
+        if (fmt === "iso") {
+            result.datetime = now.toISO();
+        }
+        else if (fmt === "human") {
+            result.datetime = now.toLocaleString(DateTime.DATETIME_FULL_WITH_SECONDS);
+        }
+        else if (fmt === "relative") {
+            const diff = now.diffNow(["hours", "minutes", "seconds"]);
+            result.datetime = now.toISO();
+            result.relativeToUTC = `${diff.hours}h ${diff.minutes}m ${Math.floor(diff.seconds)}s`;
+        }
+        return {
+            content: [{ type: "text", text: JSON.stringify(result, null, 2) }],
+        };
+    });
+}
+//# sourceMappingURL=current-time.js.map

package/build/tools/current-time.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"current-time.js","sourceRoot":"","sources":["../../src/tools/current-time.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAEjC,MAAM,UAAU,QAAQ,CAAC,MAAiB;IACxC,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,uLAAuL,EACvL;QACE,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wEAAwE,CAAC;QAClH,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,8EAA8E,CAAC;KACjJ,EACD,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,QAAQ,IAAI,KAAK,CAAC;QAC7B,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC;QAEvC,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;gBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,qBAAqB,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC;aACxF,CAAC;QACJ,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,IAAI,KAAK,CAAC;QAE5B,MAAM,MAAM,GAA4B;YACtC,QAAQ,EAAE,EAAE;YACZ,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,GAAG,EAAE,GAAG,CAAC,GAAG;YACZ,IAAI,EAAE,GAAG,CAAC,IAAI;YACd,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,OAAO,EAAE,GAAG,CAAC,WAAW;YACxB,UAAU,EAAE,GAAG,CAAC,UAAU;YAC1B,SAAS,EAAE,GAAG,CAAC,OAAO;YACtB,SAAS,EAAE,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;SAC9B,CAAC;QAEF,IAAI,GAAG,KAAK,KAAK,EAAE,CAAC;YAClB,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;QAChC,CAAC;aAAM,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YAC3B,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,cAAc,CAAC,QAAQ,CAAC,0BAA0B,CAAC,CAAC;QAC5E,CAAC;aAAM,IAAI,GAAG,KAAK,UAAU,EAAE,CAAC;YAC9B,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,CAAC,CAAC;YAC1D,MAAM,CAAC,QAAQ,GAAG,GAAG,CAAC,KAAK,EAAE,CAAC;YAC9B,MAAM,CAAC,aAAa,GAAG,GAAG,IAAI,CAAC,KAAK,KAAK,IAAI,CAAC,OAAO,KAAK,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC;QACxF,CAAC;QAED,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/build/tools/date-calc.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/build/tools/date-calc.js

@@ -0,0 +1,149 @@
+import { z } from "zod";
+import { DateTime } from "luxon";
+import { Solar, Lunar } from "lunar-typescript";
+import { resolveFestivalDate } from "../data/festivals-cn.js";
+import { resolveUSFestivalDate } from "../data/festivals-us.js";
+export function register(server) {
+    server.tool("calculate_time", "Add or subtract time from a date. Supports Gregorian mode, Lunar mode, and anchor mode (calculate relative to a named festival).", {
+        mode: z.enum(["gregorian", "lunar", "anchor"]).optional().describe("Calculation mode. Defaults to 'gregorian'."),
+        base_date: z.string().optional().describe("Base date in ISO format (YYYY-MM-DD or full ISO 8601). Required for gregorian/lunar modes."),
+        timezone: z.string().optional().describe("IANA timezone for the base date. Defaults to UTC."),
+        years: z.number().int().optional().describe("Years to add (negative to subtract)"),
+        months: z.number().int().optional().describe("Months to add (negative to subtract)"),
+        days: z.number().int().optional().describe("Days to add (negative to subtract)"),
+        hours: z.number().int().optional().describe("Hours to add (negative to subtract)"),
+        minutes: z.number().int().optional().describe("Minutes to add (negative to subtract)"),
+        // Anchor mode params
+        festival: z.string().optional().describe("Festival name for anchor mode (e.g. '春节', 'Christmas', 'Thanksgiving')"),
+        festival_year: z.number().int().optional().describe("Year to resolve festival date for anchor mode"),
+    }, async ({ mode, base_date, timezone, years, months, days, hours, minutes, festival, festival_year }) => {
+        try {
+            const calcMode = mode || "gregorian";
+            const tz = timezone || "UTC";
+            let baseDateTime;
+            if (calcMode === "anchor") {
+                if (!festival) {
+                    return { content: [{ type: "text", text: JSON.stringify({ error: "festival is required for anchor mode" }) }] };
+                }
+                const festYear = festival_year || DateTime.now().year;
+                // Try Chinese festivals first
+                let resolved = resolveFestivalDate(festival, festYear);
+                if (resolved) {
+                    baseDateTime = DateTime.fromObject({ year: resolved.getYear(), month: resolved.getMonth(), day: resolved.getDay() }, { zone: tz });
+                }
+                else {
+                    // Try US festivals
+                    const usResult = resolveUSFestivalDate(festival, festYear);
+                    if (usResult) {
+                        baseDateTime = DateTime.fromObject({ year: festYear, month: usResult.month, day: usResult.day }, { zone: tz });
+                    }
+                    else {
+                        return { content: [{ type: "text", text: JSON.stringify({ error: `Festival not found: ${festival}` }) }] };
+                    }
+                }
+            }
+            else if (!base_date) {
+                return { content: [{ type: "text", text: JSON.stringify({ error: "base_date is required for gregorian/lunar modes" }) }] };
+            }
+            else {
+                baseDateTime = DateTime.fromISO(base_date, { zone: tz });
+            }
+            if (!baseDateTime.isValid) {
+                return { content: [{ type: "text", text: JSON.stringify({ error: `Invalid date: ${baseDateTime.invalidExplanation}` }) }] };
+            }
+            if (calcMode === "lunar") {
+                // Convert to lunar, add, convert back
+                const solar = Solar.fromYmd(baseDateTime.year, baseDateTime.month, baseDateTime.day);
+                const lunar = solar.getLunar();
+                // Add days using Lunar.next()
+                let totalLunarDays = (days || 0);
+                // For months in lunar calendar, approximate as 30 days per month
+                // Actually, let's handle months by manipulating lunar month/day directly
+                let targetLunar;
+                if (months || years) {
+                    // Calculate target lunar date
+                    let targetMonth = lunar.getMonth() + (months || 0);
+                    let targetYear = lunar.getYear() + (years || 0);
+                    // Normalize months
+                    while (targetMonth > 12) {
+                        targetMonth -= 12;
+                        targetYear++;
+                    }
+                    while (targetMonth < 1) {
+                        targetMonth += 12;
+                        targetYear--;
+                    }
+                    let targetDay = lunar.getDay();
+                    // Clamp day to valid range
+                    try {
+                        targetLunar = Lunar.fromYmd(targetYear, targetMonth, targetDay);
+                    }
+                    catch {
+                        // Day doesn't exist in target month, use last valid day
+                        try {
+                            targetLunar = Lunar.fromYmd(targetYear, targetMonth, 29);
+                        }
+                        catch {
+                            targetLunar = Lunar.fromYmd(targetYear, targetMonth, 28);
+                        }
+                    }
+                }
+                else {
+                    targetLunar = lunar;
+                }
+                // Then add remaining days
+                if (totalLunarDays !== 0) {
+                    targetLunar = targetLunar.next(totalLunarDays);
+                }
+                const resultSolar = targetLunar.getSolar();
+                let resultDt = DateTime.fromObject({ year: resultSolar.getYear(), month: resultSolar.getMonth(), day: resultSolar.getDay() }, { zone: tz });
+                // Add hours/minutes in Gregorian space
+                if (hours)
+                    resultDt = resultDt.plus({ hours });
+                if (minutes)
+                    resultDt = resultDt.plus({ minutes });
+                const result = {
+                    mode: "lunar",
+                    base: {
+                        gregorian: baseDateTime.toISODate(),
+                        lunar: `${lunar.getYearInChinese()}年${lunar.getMonthInChinese()}月${lunar.getDayInChinese()}`,
+                    },
+                    offset: { years: years || 0, months: months || 0, days: days || 0, hours: hours || 0, minutes: minutes || 0 },
+                    result: {
+                        gregorian: resultDt.toISO(),
+                        lunar: `${targetLunar.getYearInChinese()}年${targetLunar.getMonthInChinese()}月${targetLunar.getDayInChinese()}`,
+                        lunarYear: targetLunar.getYear(),
+                        lunarMonth: targetLunar.getMonth(),
+                        lunarDay: targetLunar.getDay(),
+                    },
+                };
+                return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+            }
+            // Gregorian mode (also used for anchor after resolving base)
+            const resultDt = baseDateTime.plus({
+                years: years || 0,
+                months: months || 0,
+                days: days || 0,
+                hours: hours || 0,
+                minutes: minutes || 0,
+            });
+            const result = {
+                mode: calcMode,
+                base: baseDateTime.toISO(),
+                offset: { years: years || 0, months: months || 0, days: days || 0, hours: hours || 0, minutes: minutes || 0 },
+                result: resultDt.toISO(),
+                resultDate: resultDt.toISODate(),
+                weekday: resultDt.weekdayLong,
+            };
+            if (calcMode === "anchor") {
+                result.festival = festival;
+                result.festivalYear = festival_year || DateTime.now().year;
+            }
+            return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: e.message || String(e) }) }] };
+        }
+    });
+}
+//# sourceMappingURL=date-calc.js.map

package/build/tools/date-calc.js.map

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

package/build/tools/date-diff.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/build/tools/date-diff.js

@@ -0,0 +1,45 @@
+import { z } from "zod";
+import { DateTime, Interval } from "luxon";
+export function register(server) {
+    server.tool("date_diff", "Calculate the difference between two dates/times. Returns the difference in years, months, days, hours, minutes and also total days/hours/minutes.", {
+        start: z.string().describe("Start date in ISO 8601 format (e.g. 2024-01-15 or 2024-01-15T10:30:00)"),
+        end: z.string().describe("End date in ISO 8601 format"),
+        timezone: z.string().optional().describe("IANA timezone for parsing dates. Defaults to UTC."),
+    }, async ({ start, end, timezone }) => {
+        const tz = timezone || "UTC";
+        const startDt = DateTime.fromISO(start, { zone: tz });
+        const endDt = DateTime.fromISO(end, { zone: tz });
+        if (!startDt.isValid) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `Invalid start date: ${startDt.invalidExplanation}` }) }] };
+        }
+        if (!endDt.isValid) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: `Invalid end date: ${endDt.invalidExplanation}` }) }] };
+        }
+        // Ensure start <= end for interval
+        const [earlier, later] = startDt < endDt ? [startDt, endDt] : [endDt, startDt];
+        const isNegative = startDt > endDt;
+        const interval = Interval.fromDateTimes(earlier, later);
+        const duration = interval.toDuration(["years", "months", "days", "hours", "minutes", "seconds"]);
+        const totalDiff = later.diff(earlier, ["days", "hours", "minutes", "seconds"]);
+        const result = {
+            start: startDt.toISO(),
+            end: endDt.toISO(),
+            timezone: tz,
+            isNegative,
+            difference: {
+                years: duration.years,
+                months: duration.months,
+                days: duration.days,
+                hours: duration.hours,
+                minutes: duration.minutes,
+                seconds: Math.floor(duration.seconds),
+            },
+            totalDays: Math.floor(totalDiff.as("days")),
+            totalHours: Math.floor(totalDiff.as("hours")),
+            totalMinutes: Math.floor(totalDiff.as("minutes")),
+            totalSeconds: Math.floor(totalDiff.as("seconds")),
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=date-diff.js.map

package/build/tools/date-diff.js.map

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

package/build/tools/festivals.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, dataDir: string): void;

package/build/tools/festivals.js

@@ -0,0 +1,94 @@
+import { z } from "zod";
+import { Solar } from "lunar-typescript";
+import { DateTime } from "luxon";
+import { getHolidays } from "../data/holidays.js";
+export function register(server, dataDir) {
+    server.tool("get_festivals", "Get festivals, solar terms, and public holidays within a date range. Supports Chinese (lunar and solar) festivals and public holidays from various countries.", {
+        start_date: z.string().describe("Start date in YYYY-MM-DD format"),
+        end_date: z.string().describe("End date in YYYY-MM-DD format"),
+        country: z.string().optional().describe("Country code for public holidays (e.g. CN, US, HK). Defaults to CN."),
+        types: z.array(z.enum(["lunar_festival", "solar_festival", "solar_term", "public_holiday"])).optional()
+            .describe("Filter by event types. If omitted, returns all types."),
+    }, async ({ start_date, end_date, country, types }) => {
+        try {
+            const countryCode = country || "CN";
+            const startDt = DateTime.fromISO(start_date);
+            const endDt = DateTime.fromISO(end_date);
+            if (!startDt.isValid || !endDt.isValid) {
+                return { content: [{ type: "text", text: JSON.stringify({ error: "Invalid date format. Use YYYY-MM-DD." }) }] };
+            }
+            // Preload holidays for the year range
+            const startYear = startDt.year;
+            const endYear = endDt.year;
+            const holidayMaps = new Map();
+            for (let y = startYear; y <= endYear; y++) {
+                holidayMaps.set(y, await getHolidays(dataDir, countryCode, y));
+            }
+            const entries = [];
+            let current = startDt;
+            while (current <= endDt) {
+                const y = current.year;
+                const m = current.month;
+                const d = current.day;
+                const dateStr = current.toISODate();
+                const solar = Solar.fromYmd(y, m, d);
+                const lunar = solar.getLunar();
+                const entry = {
+                    date: dateStr,
+                    festivals: [],
+                };
+                // Lunar info
+                entry.lunarDate = `${lunar.getMonthInChinese()}月${lunar.getDayInChinese()}`;
+                // Solar term
+                const jieQi = lunar.getJieQi();
+                if (jieQi) {
+                    if (!types || types.includes("solar_term")) {
+                        entry.solarTerm = jieQi;
+                    }
+                }
+                // Lunar festivals
+                const lunarFestivals = lunar.getFestivals();
+                if (lunarFestivals.length > 0 && (!types || types.includes("lunar_festival"))) {
+                    entry.festivals.push(...lunarFestivals);
+                }
+                // Solar festivals
+                const solarFestivals = solar.getFestivals();
+                if (solarFestivals.length > 0 && (!types || types.includes("solar_festival"))) {
+                    entry.festivals.push(...solarFestivals);
+                }
+                // Other festivals (from lunar-typescript)
+                const otherLunar = lunar.getOtherFestivals();
+                if (otherLunar.length > 0 && (!types || types.includes("lunar_festival"))) {
+                    entry.festivals.push(...otherLunar);
+                }
+                const otherSolar = solar.getOtherFestivals();
+                if (otherSolar.length > 0 && (!types || types.includes("solar_festival"))) {
+                    entry.festivals.push(...otherSolar);
+                }
+                // Public holidays from API cache
+                if (!types || types.includes("public_holiday")) {
+                    const holidayMap = holidayMaps.get(y);
+                    if (holidayMap) {
+                        const holiday = holidayMap.get(dateStr);
+                        if (holiday) {
+                            entry.isPublicHoliday = holiday.isOffDay;
+                            entry.holidayName = holiday.name;
+                        }
+                    }
+                }
+                // Only include days with something interesting
+                if (entry.festivals.length > 0 || entry.solarTerm || entry.isPublicHoliday !== undefined) {
+                    entries.push(entry);
+                }
+                current = current.plus({ days: 1 });
+            }
+            return {
+                content: [{ type: "text", text: JSON.stringify({ count: entries.length, entries }, null, 2) }],
+            };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: e.message || String(e) }) }] };
+        }
+    });
+}
+//# sourceMappingURL=festivals.js.map

package/build/tools/festivals.js.map

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

package/build/tools/manage-countdown.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer, dataDir: string): void;

package/build/tools/manage-countdown.js

@@ -0,0 +1,120 @@
+import { z } from "zod";
+import { existsSync, readFileSync, writeFileSync, mkdirSync } from "fs";
+import { join, dirname } from "path";
+import { DateTime } from "luxon";
+function getFilePath(dataDir) {
+    return join(dataDir, "countdown.json");
+}
+function loadCountdowns(dataDir) {
+    const file = getFilePath(dataDir);
+    if (!existsSync(file))
+        return [];
+    try {
+        return JSON.parse(readFileSync(file, "utf-8"));
+    }
+    catch {
+        return [];
+    }
+}
+function saveCountdowns(dataDir, items) {
+    const file = getFilePath(dataDir);
+    mkdirSync(dirname(file), { recursive: true });
+    writeFileSync(file, JSON.stringify(items, null, 2), "utf-8");
+}
+export function register(server, dataDir) {
+    server.tool("manage_countdown", "Manage persistent countdown timers. Supports CRUD operations: set (create), get (read one), list (read all), delete.", {
+        action: z.enum(["set", "get", "list", "delete"]).describe("Action to perform"),
+        id: z.string().optional().describe("Countdown ID (required for get/delete, auto-generated for set if not provided)"),
+        name: z.string().optional().describe("Name/description for the countdown (required for set)"),
+        target_date: z.string().optional().describe("Target date in ISO 8601 format (required for set)"),
+        timezone: z.string().optional().describe("IANA timezone. Defaults to UTC."),
+    }, async ({ action, id, name, target_date, timezone }) => {
+        const tz = timezone || "UTC";
+        try {
+            if (action === "set") {
+                if (!name)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: "name is required for set action" }) }] };
+                if (!target_date)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: "target_date is required for set action" }) }] };
+                const targetDt = DateTime.fromISO(target_date, { zone: tz });
+                if (!targetDt.isValid) {
+                    return { content: [{ type: "text", text: JSON.stringify({ error: `Invalid target_date: ${targetDt.invalidExplanation}` }) }] };
+                }
+                const items = loadCountdowns(dataDir);
+                const newItem = {
+                    id: id || `cd_${Date.now().toString(36)}`,
+                    name,
+                    targetDate: targetDt.toISO(),
+                    timezone: tz,
+                    createdAt: DateTime.now().toISO(),
+                };
+                // Replace if same ID exists
+                const existingIdx = items.findIndex(i => i.id === newItem.id);
+                if (existingIdx >= 0) {
+                    items[existingIdx] = newItem;
+                }
+                else {
+                    items.push(newItem);
+                }
+                saveCountdowns(dataDir, items);
+                return { content: [{ type: "text", text: JSON.stringify({ success: true, item: newItem }, null, 2) }] };
+            }
+            if (action === "get") {
+                if (!id)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: "id is required for get action" }) }] };
+                const items = loadCountdowns(dataDir);
+                const item = items.find(i => i.id === id);
+                if (!item)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: `Countdown not found: ${id}` }) }] };
+                const now = DateTime.now().setZone(item.timezone);
+                const targetDt = DateTime.fromISO(item.targetDate, { zone: item.timezone });
+                const isPast = targetDt < now;
+                const [earlier, later] = isPast ? [targetDt, now] : [now, targetDt];
+                const diff = later.diff(earlier, ["days", "hours", "minutes", "seconds"]);
+                return {
+                    content: [{
+                            type: "text",
+                            text: JSON.stringify({
+                                ...item,
+                                isPast,
+                                remaining: {
+                                    days: Math.floor(diff.days),
+                                    hours: Math.floor(diff.hours),
+                                    minutes: Math.floor(diff.minutes),
+                                    seconds: Math.floor(diff.seconds),
+                                },
+                                totalDays: Math.floor(diff.as("days")),
+                            }, null, 2),
+                        }],
+                };
+            }
+            if (action === "list") {
+                const items = loadCountdowns(dataDir);
+                const now = DateTime.now();
+                const enriched = items.map(item => {
+                    const targetDt = DateTime.fromISO(item.targetDate, { zone: item.timezone });
+                    const isPast = targetDt < now;
+                    const totalDays = Math.floor(Math.abs(targetDt.diff(now, "days").days));
+                    return { ...item, isPast, totalDays };
+                });
+                return { content: [{ type: "text", text: JSON.stringify({ count: enriched.length, items: enriched }, null, 2) }] };
+            }
+            if (action === "delete") {
+                if (!id)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: "id is required for delete action" }) }] };
+                const items = loadCountdowns(dataDir);
+                const idx = items.findIndex(i => i.id === id);
+                if (idx < 0)
+                    return { content: [{ type: "text", text: JSON.stringify({ error: `Countdown not found: ${id}` }) }] };
+                const removed = items.splice(idx, 1)[0];
+                saveCountdowns(dataDir, items);
+                return { content: [{ type: "text", text: JSON.stringify({ success: true, deleted: removed }, null, 2) }] };
+            }
+            return { content: [{ type: "text", text: JSON.stringify({ error: `Unknown action: ${action}` }) }] };
+        }
+        catch (e) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: e.message || String(e) }) }] };
+        }
+    });
+}
+//# sourceMappingURL=manage-countdown.js.map

package/build/tools/manage-countdown.js.map

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

package/build/tools/month-info.d.ts

@@ -0,0 +1,2 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function register(server: McpServer): void;

package/build/tools/month-info.js

@@ -0,0 +1,30 @@
+import { z } from "zod";
+import { DateTime } from "luxon";
+export function register(server) {
+    server.tool("get_month_info", "Get detailed information about a specific month including number of days, first/last day weekday, whether it's a leap year, and quarter.", {
+        year: z.number().int().describe("Year (e.g. 2024)"),
+        month: z.number().int().min(1).max(12).describe("Month (1-12)"),
+    }, async ({ year, month }) => {
+        const dt = DateTime.fromObject({ year, month, day: 1 });
+        if (!dt.isValid) {
+            return { content: [{ type: "text", text: JSON.stringify({ error: "Invalid year/month" }) }] };
+        }
+        const daysInMonth = dt.daysInMonth;
+        const lastDay = DateTime.fromObject({ year, month, day: daysInMonth });
+        const result = {
+            year,
+            month,
+            monthName: dt.monthLong,
+            daysInMonth,
+            firstDayWeekday: dt.weekdayLong,
+            firstDayWeekdayNumber: dt.weekday, // 1=Monday, 7=Sunday (ISO)
+            lastDayWeekday: lastDay.weekdayLong,
+            lastDayWeekdayNumber: lastDay.weekday,
+            isLeapYear: dt.isInLeapYear,
+            quarter: dt.quarter,
+            weekCount: Math.ceil((daysInMonth + dt.weekday - 1) / 7),
+        };
+        return { content: [{ type: "text", text: JSON.stringify(result, null, 2) }] };
+    });
+}
+//# sourceMappingURL=month-info.js.map