@dhcckb/mcp-server-dila-time 1.0.0

package/README.md

@@ -0,0 +1,80 @@
+# @dhp/mcp-server-dila-time
+
+MCP Server for Chinese-Western calendar conversion using the [DILA Buddhist Studies Time Authority Database](https://authority.dila.edu.tw/time/index.php).
+
+## Features
+
+- **Chinese → Western Calendar Conversion**: Convert dynasty + era name + year to Western (Gregorian/Julian) dates
+- **Era Name Search**: Fuzzy search for dynasty and era names by keyword
+- **Ganzhi (Sexagenary Cycle) Lookup**: Find Western years corresponding to a Chinese sexagenary cycle combination
+
+## Installation
+
+```bash
+npx @dhp/mcp-server-dila-time
+```
+
+Or install globally:
+
+```bash
+npm install -g @dhp/mcp-server-dila-time
+mcp-server-dila-time
+```
+
+## MCP Client Configuration
+
+Add to your MCP client configuration (e.g., Claude Desktop `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "dila-time": {
+      "command": "npx",
+      "args": ["-y", "@dhp/mcp-server-dila-time"]
+    }
+  }
+}
+```
+
+## Tools
+
+### `dila_convert_chinese_to_western`
+
+Convert a Chinese calendar date to Western calendar date.
+
+**Parameters:**
+- `dynasty` (required): Dynasty name, e.g., 唐, 宋, 明, 清
+- `era_name` (required): Era/reign name, e.g., 贞观, 康熙, 乾隆
+- `year` (required): Year number within the era, e.g., 3 for 贞观三年
+- `month` (optional): Lunar month (1-12)
+- `day` (optional): Lunar day (1-30)
+- `month_is_leap` (optional): Whether it's a leap month, default false
+
+### `dila_search_era_names`
+
+Search for dynasty or era names by keyword.
+
+**Parameters:**
+- `keyword` (required): Search keyword (partial dynasty or era name)
+- `dynasty` (optional): Limit results to a specific dynasty
+- `limit` (optional): Maximum number of results, default 10
+
+### `dila_lookup_ganzhi_year`
+
+Look up Western years for a given sexagenary cycle combination.
+
+**Parameters:**
+- `ganzhi` (required): Sexagenary cycle combination, e.g., 甲子, 乙丑, 戊戌
+- `dynasty` (optional): Limit results to a specific dynasty
+
+## Data Source
+
+All data is sourced from the [DILA Buddhist Studies Time Authority Database](https://authority.dila.edu.tw/time/index.php), maintained by the Dharma Drum Institute of Liberal Arts.
+
+## Fallback
+
+If the DILA website is unavailable or its HTML structure changes, the tools will return an error with a suggestion to visit https://authority.dila.edu.tw/time/index.php directly.
+
+## License
+
+MIT

package/dist/dila-client.d.ts

@@ -0,0 +1,37 @@
+declare const FALLBACK_URL = "https://authority.dila.edu.tw/time/index.php";
+/** Fallback message when parsing fails */
+declare const FALLBACK_MESSAGE = "\u6570\u636E\u89E3\u6790\u5931\u8D25\uFF0C\u53EF\u80FD\u662F DILA \u7F51\u7AD9 HTML \u7ED3\u6784\u53D1\u751F\u4E86\u53D8\u5316\u3002\u8BF7\u624B\u52A8\u8BBF\u95EE https://authority.dila.edu.tw/time/index.php \u8FDB\u884C\u67E5\u8BE2\u3002";
+export interface EraResult {
+    dynasty: string;
+    emperor: string;
+    eraName: string;
+    duration: string;
+    westernStart: string;
+    westernEnd: string;
+}
+export interface GanzhiResult {
+    westernStart: string;
+    westernEnd: string;
+    dynasty: string;
+    emperor: string;
+    eraName: string;
+    year: string;
+    description: string;
+}
+/**
+ * Query DILA for era/reign name information.
+ */
+export declare function queryEraInfo(params: {
+    dynasty?: string;
+    eraName?: string;
+    keyword?: string;
+}): Promise<EraResult[]>;
+/**
+ * Query DILA for ganzhi (sexagenary cycle) year lookup.
+ */
+export declare function queryGanzhi(params: {
+    ganzhi: string;
+    dynasty?: string;
+}): Promise<GanzhiResult[]>;
+export { FALLBACK_URL, FALLBACK_MESSAGE };
+//# sourceMappingURL=dila-client.d.ts.map

package/dist/dila-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dila-client.d.ts","sourceRoot":"","sources":["../src/dila-client.ts"],"names":[],"mappings":"AAOA,QAAA,MAAM,YAAY,iDAAiD,CAAC;AAEpE,0CAA0C;AAC1C,QAAA,MAAM,gBAAgB,mPACyC,CAAC;AAEhE,MAAM,WAAW,SAAS;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,YAAY;IAC3B,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;CACrB;AAwLD;;GAEG;AACH,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,SAAS,EAAE,CAAC,CAgCvB;AAED;;GAEG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC,YAAY,EAAE,CAAC,CAoB1B;AAED,OAAO,EAAE,YAAY,EAAE,gBAAgB,EAAE,CAAC"}

package/dist/dila-client.js

@@ -0,0 +1,257 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FALLBACK_MESSAGE = exports.FALLBACK_URL = void 0;
+exports.queryEraInfo = queryEraInfo;
+exports.queryGanzhi = queryGanzhi;
+const axios_1 = __importDefault(require("axios"));
+const cheerio = __importStar(require("cheerio"));
+const DILA_BASE_URL = "https://authority.dila.edu.tw/time/";
+const DILA_SEARCH_URL = `${DILA_BASE_URL}search.php`;
+const USER_AGENT = "Mozilla/5.0 (X11; Linux x86_64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36";
+const FALLBACK_URL = "https://authority.dila.edu.tw/time/index.php";
+exports.FALLBACK_URL = FALLBACK_URL;
+/** Fallback message when parsing fails */
+const FALLBACK_MESSAGE = `数据解析失败，可能是 DILA 网站 HTML 结构发生了变化。请手动访问 ${FALLBACK_URL} 进行查询。`;
+exports.FALLBACK_MESSAGE = FALLBACK_MESSAGE;
+/**
+ * Search DILA for era/time information.
+ */
+async function searchDILA(params) {
+    try {
+        const response = await axios_1.default.get(DILA_SEARCH_URL, {
+            params: {
+                julianSwitch: "on",
+                ...params,
+            },
+            headers: {
+                Referer: `${DILA_BASE_URL}form.php`,
+                "User-Agent": USER_AGENT,
+                Accept: "text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8",
+            },
+            timeout: 15000,
+        });
+        return response.data;
+    }
+    catch (error) {
+        if (axios_1.default.isAxiosError(error)) {
+            if (error.code === "ECONNREFUSED" || error.code === "ENOTFOUND") {
+                throw new Error(`无法连接到 DILA 服务器 (${DILA_BASE_URL})，请检查网络连接。\n备选方案：手动访问 ${FALLBACK_URL}`);
+            }
+            if (error.response?.status === 404) {
+                throw new Error(`DILA 查询接口返回 404，可能网站已更新。\n备选方案：手动访问 ${FALLBACK_URL}`);
+            }
+            if (error.code === "ETIMEDOUT" || error.code === "ECONNABORTED") {
+                throw new Error(`DILA 服务器响应超时，请稍后重试。\n备选方案：手动访问 ${FALLBACK_URL}`);
+            }
+        }
+        throw new Error(`查询 DILA 时发生未知错误：${error instanceof Error ? error.message : String(error)}\n备选方案：手动访问 ${FALLBACK_URL}`);
+    }
+}
+/**
+ * Parse era/dynasty search results from HTML.
+ * Results use <tr class="rowClass"> with 6 <td> elements:
+ *   [0] link+arrow, [1] dynasty, [2] emperor, [3] era name, [4] duration, [5] date range
+ */
+function parseEraResults(html) {
+    const $ = cheerio.load(html);
+    const results = [];
+    $("tr.rowClass").each((_, row) => {
+        const tds = $(row).find("td");
+        if (tds.length < 6)
+            return;
+        const dynasty = $(tds[1]).text().trim();
+        const emperor = $(tds[2]).text().trim();
+        const eraRaw = $(tds[3]).text().trim();
+        // Remove alternative names in brackets like 貞觀[正觀]
+        const eraName = eraRaw.replace(/\[.*\]$/, "").trim();
+        const duration = $(tds[4]).text().trim();
+        const dateRangeText = $(tds[5]).text().trim();
+        const { westernStart, westernEnd } = parseDateRange(dateRangeText);
+        results.push({
+            dynasty,
+            emperor,
+            eraName,
+            duration,
+            westernStart,
+            westernEnd,
+        });
+    });
+    return results;
+}
+/**
+ * Parse ganzhi search results from HTML.
+ * Results use <tr valign=top> with 3 <td> elements:
+ *   [0] link+arrow, [1] date range + ID, [2] dynasty/emperor/era/year info
+ */
+function parseGanzhiResults(html) {
+    const $ = cheerio.load(html);
+    const results = [];
+    $('tr[valign="top"]').each((_, row) => {
+        const tds = $(row).find("td");
+        if (tds.length < 3)
+            return;
+        const dateRangeText = $(tds[1])
+            .text()
+            .replace(/\s*\(\d+\)\s*/g, "")
+            .trim();
+        const infoText = $(tds[2]).text().trim();
+        const { westernStart, westernEnd } = parseDateRange(dateRangeText);
+        // Parse info text: "西漢 高祖  \n（無年號） 六年 （庚子） \n  戊午 朔"
+        const lines = infoText.split("\n").map((l) => l.trim()).filter(Boolean);
+        const mainLine = lines[0] || "";
+        // Pattern: "朝代 帝号  年号 年份 （干支）"
+        const parts = mainLine.split(/\s+/).filter(Boolean);
+        let dynasty = "";
+        let emperor = "";
+        let eraName = "";
+        let year = "";
+        let description = infoText;
+        if (parts.length >= 1)
+            dynasty = parts[0];
+        if (parts.length >= 2)
+            emperor = parts[1];
+        // Era name may contain parentheses and Chinese chars
+        if (parts.length >= 3) {
+            // The era name might span multiple parts
+            const eraParts = [];
+            let i = 2;
+            while (i < parts.length && !/^\d/.test(parts[i]) && !parts[i].startsWith("（")) {
+                eraParts.push(parts[i]);
+                i++;
+            }
+            eraName = eraParts.join("");
+            if (i < parts.length) {
+                year = parts[i];
+            }
+        }
+        results.push({
+            westernStart,
+            westernEnd,
+            dynasty,
+            emperor,
+            eraName,
+            year,
+            description,
+        });
+    });
+    return results;
+}
+/**
+ * Parse date range text like:
+ *   "[ C.E. +0618-06-21  ~  C.E. +0626-09-05 ]"
+ *   "-0201-11-15  ~  -0200-11-03"
+ *   "+0040-01-31  ~  +0041-02-17"
+ */
+function parseDateRange(text) {
+    // Pattern 1: "[ C.E. +YYYY-MM-DD  ~  C.E. +YYYY-MM-DD ]"
+    let match = text.match(/C\.E\.\s*([+-]?\d{4}-\d{2}-\d{2})\s*~\s*C\.E\.\s*([+-]?\d{4}-\d{2}-\d{2})/);
+    if (match) {
+        return {
+            westernStart: normalizeYear(match[1]),
+            westernEnd: normalizeYear(match[2]),
+        };
+    }
+    // Pattern 2: "+YYYY-MM-DD  ~  +YYYY-MM-DD" or "-YYYY-MM-DD  ~  -YYYY-MM-DD"
+    match = text.match(/([+-]?\d{4}-\d{2}-\d{2})\s*~\s*([+-]?\d{4}-\d{2}-\d{2})/);
+    if (match) {
+        return {
+            westernStart: normalizeYear(match[1]),
+            westernEnd: normalizeYear(match[2]),
+        };
+    }
+    return { westernStart: "", westernEnd: "" };
+}
+/**
+ * Normalize year format: convert "+0618" to "618", keep "-0201" as "-201"
+ */
+function normalizeYear(dateStr) {
+    return dateStr.replace(/^\+0*/, "").replace(/^-0*/, "-");
+}
+/**
+ * Query DILA for era/reign name information.
+ */
+async function queryEraInfo(params) {
+    const queryParams = {
+        chk: "on",
+        "filterType[]": "chinese",
+        julianSwitch: "on",
+    };
+    if (params.dynasty)
+        queryParams.dpk = params.dynasty;
+    // If we have an eraName, use it; otherwise if we have a keyword,
+    // use the keyword as the era search parameter (ypk)
+    if (params.eraName) {
+        queryParams.ypk = params.eraName;
+    }
+    else if (params.keyword) {
+        queryParams.ypk = params.keyword;
+    }
+    const html = await searchDILA(queryParams);
+    let results = parseEraResults(html);
+    // Further filter by keyword if provided (fuzzy match on dynasty, era name, or emperor)
+    if (params.keyword) {
+        const kw = params.keyword.toLowerCase();
+        results = results.filter((r) => r.dynasty.toLowerCase().includes(kw) ||
+            r.eraName.toLowerCase().includes(kw) ||
+            r.emperor.toLowerCase().includes(kw));
+    }
+    return results;
+}
+/**
+ * Query DILA for ganzhi (sexagenary cycle) year lookup.
+ */
+async function queryGanzhi(params) {
+    const queryParams = {
+        chk: "on",
+        gz: params.ganzhi,
+        "filterType[]": "chinese",
+        julianSwitch: "on",
+    };
+    if (params.dynasty)
+        queryParams.dpk = params.dynasty;
+    const html = await searchDILA(queryParams);
+    let results = parseGanzhiResults(html);
+    // Filter by dynasty if provided
+    if (params.dynasty) {
+        const dyn = params.dynasty;
+        results = results.filter((r) => r.dynasty.includes(dyn));
+    }
+    return results;
+}
+//# sourceMappingURL=dila-client.js.map

package/dist/dila-client.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,368 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const dila_client_js_1 = require("./dila-client.js");
+const DILA_SITE_URL = "https://authority.dila.edu.tw/time/index.php";
+// ─── Tool Definitions ───────────────────────────────────────────────
+const tools = [
+    {
+        name: "dila_convert_chinese_to_western",
+        description: "将中历日期转换为西历日期。输入朝代、年号、年份、月份（可选）、日期（可选），返回对应的西历年月日或年份范围。基于 DILA 佛学规范资料库权威数据。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                dynasty: {
+                    type: "string",
+                    description: "朝代名称，如：唐、宋、明、清等",
+                },
+                era_name: {
+                    type: "string",
+                    description: "年号名称，如：贞观、康熙、乾隆等",
+                },
+                year: {
+                    type: "integer",
+                    description: "年号纪年（数字），如 3 代表贞观三年",
+                },
+                month: {
+                    type: "integer",
+                    description: "农历月份（1-12），可选",
+                },
+                day: {
+                    type: "integer",
+                    description: "农历日期（1-30），可选",
+                },
+                month_is_leap: {
+                    type: "boolean",
+                    description: "是否为闰月，可选，默认 false",
+                },
+            },
+            required: ["dynasty", "era_name", "year"],
+        },
+    },
+    {
+        name: "dila_search_era_names",
+        description: "根据关键词搜索朝代或年号信息。用于用户在不确定完整年号名称时进行模糊匹配。返回匹配的年号列表及其所属朝代和起止西历年份。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                keyword: {
+                    type: "string",
+                    description: "搜索关键词，可以是朝代名或年号名的部分文字",
+                },
+                dynasty: {
+                    type: "string",
+                    description: "限定朝代范围，可选",
+                },
+                limit: {
+                    type: "integer",
+                    description: "返回结果数量上限，默认 10",
+                },
+            },
+            required: ["keyword"],
+        },
+    },
+    {
+        name: "dila_lookup_ganzhi_year",
+        description: "通过干支纪年查找对应的西历年份。输入干支组合（如：甲子、乙丑）和可选的朝代限定，返回对应的西历年份列表。",
+        inputSchema: {
+            type: "object",
+            properties: {
+                ganzhi: {
+                    type: "string",
+                    description: "干支纪年，如：甲子、乙丑、戊戌等",
+                },
+                dynasty: {
+                    type: "string",
+                    description: "限定朝代范围，可选",
+                },
+            },
+            required: ["ganzhi"],
+        },
+    },
+];
+// ─── Helper Functions ───────────────────────────────────────────────
+/**
+ * Compute the western year for a specific year within an era.
+ * The era record gives the date range for the entire era (era years 1..N).
+ * For year N in the era, the western year = era_start_year + (N-1).
+ * If month/day are provided, we return the era range as a reference
+ * (since precise month/day conversion requires more complex ephemeris).
+ */
+function computeYearFromEra(era, targetYear, month, day, monthIsLeap) {
+    // Extract year numbers from the era date range
+    // westernStart format: "627-01-26" or "-201-11-15"
+    const startParts = era.westernStart.split("-");
+    const startYear = parseInt(startParts[0], 10);
+    const startSign = era.westernStart.startsWith("-") ? -1 : 1;
+    const endParts = era.westernEnd.split("-");
+    const endYear = parseInt(endParts[0], 10);
+    const endSign = era.westernEnd.startsWith("-") ? -1 : 1;
+    // Calculate the target year's estimated range
+    const eraLength = parseInt(era.duration.replace(/[^0-9]/g, ""), 10) || 1;
+    if (targetYear < 1 || targetYear > eraLength) {
+        return {
+            westernYearStart: "",
+            westernYearEnd: "",
+            estimatedWesternStart: "",
+            estimatedWesternEnd: "",
+            note: `年号 "${era.eraName}" 只有 ${eraLength} 年，您查询的第 ${targetYear} 年超出范围。该年号的有效范围为第 1 年至第 ${eraLength} 年。`,
+        };
+    }
+    // Estimate: the western start for year N in the era
+    // We use the era start year + (N-1) as a rough estimate
+    const estStartYear = startSign * startYear + (targetYear - 1);
+    const estEndYear = startSign * startYear + targetYear;
+    const signStr = (n) => (n < 0 ? `公元前 ${Math.abs(n)}` : `公元 ${n}`);
+    let note = `注意：DILA 资料库返回的是年号 "${era.eraName}" 的完整时间范围（${era.westernStart} ~ ${era.westernEnd}，${era.duration}），而非单个年份的精确起止。`;
+    if (month) {
+        note += " 由于输入了月份，精度需匹配到月，但目前 DILA 仅返回年号级别的日期范围。";
+        note += ` 第 ${targetYear} 年大约对应 ${signStr(estStartYear)} 至 ${signStr(estEndYear)} 年。`;
+    }
+    if (day) {
+        note += " 输入了日期，但精确到日的换算是近似值。";
+    }
+    note += ` 如需精确到日，请手动访问 ${DILA_SITE_URL} 进行详细查询。`;
+    return {
+        westernYearStart: era.westernStart,
+        westernYearEnd: era.westernEnd,
+        estimatedWesternStart: `${estStartYear >= 0 ? "+" : "-"}${String(Math.abs(estStartYear)).padStart(4, "0")}-01-01`,
+        estimatedWesternEnd: `${estEndYear >= 0 ? "+" : "-"}${String(Math.abs(estEndYear)).padStart(4, "0")}-01-01`,
+        note,
+    };
+}
+/**
+ * Format era results for MCP tool output.
+ */
+function formatEraResults(results) {
+    if (results.length === 0) {
+        return "未找到匹配的年号信息。\n\n备选方案：请手动访问 " + DILA_SITE_URL + " 进行查询。";
+    }
+    return results
+        .map((r, i) => `${i + 1}. 【${r.dynasty}】${r.emperor} · ${r.eraName}\n` +
+        `   西历范围：${r.westernStart} ~ ${r.westernEnd}\n` +
+        `   时长：${r.duration}`)
+        .join("\n\n");
+}
+/**
+ * Format ganzhi results for MCP tool output.
+ */
+function formatGanzhiResults(results) {
+    if (results.length === 0) {
+        return "未找到匹配的干支纪年信息。\n\n备选方案：请手动访问 " + DILA_SITE_URL + " 进行查询。";
+    }
+    return results
+        .map((r, i) => `${i + 1}. 【${r.dynasty}】${r.emperor} · ${r.eraName}${r.year ? " " + r.year + "年" : ""}\n` +
+        `   西历范围：${r.westernStart} ~ ${r.westernEnd}`)
+        .join("\n\n");
+}
+// ─── Server Setup ───────────────────────────────────────────────────
+const server = new index_js_1.Server({
+    name: "@dhp/mcp-server-dila-time",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// List tools
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return { tools };
+});
+// Handle tool calls
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case "dila_convert_chinese_to_western": {
+                const dynasty = args?.dynasty;
+                const eraName = args?.era_name;
+                const year = args?.year;
+                const month = args?.month;
+                const day = args?.day;
+                const monthIsLeap = args?.month_is_leap;
+                if (!dynasty || !eraName || !year) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "错误：缺少必需参数。请提供 dynasty（朝代）、era_name（年号）和 year（年份）。",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Query DILA for the era information
+                const results = await (0, dila_client_js_1.queryEraInfo)({
+                    dynasty,
+                    eraName,
+                });
+                if (results.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `未找到匹配的结果：朝代="${dynasty}"，年号="${eraName}"。\n\n` +
+                                    `建议：\n` +
+                                    `1. 检查朝代和年号名称是否正确\n` +
+                                    `2. 使用 dila_search_era_names 工具搜索年号\n` +
+                                    `3. 手动访问 ${DILA_SITE_URL} 查询`,
+                            },
+                        ],
+                    };
+                }
+                // Filter to the specific era that matches (same dynasty and era name)
+                const exactMatch = results.find((r) => r.dynasty === dynasty &&
+                    (r.eraName === eraName ||
+                        r.eraName.includes(eraName) ||
+                        eraName.includes(r.eraName))) || results[0];
+                const computed = computeYearFromEra(exactMatch, year, month, day, monthIsLeap);
+                let output = `# 中历 → 西历 转换结果\n\n`;
+                output += `**朝代**：${exactMatch.dynasty}\n`;
+                output += `**帝号**：${exactMatch.emperor}\n`;
+                output += `**年号**：${exactMatch.eraName}\n`;
+                output += `**第 ${year} 年**`;
+                if (month)
+                    output += ` ${month} 月`;
+                if (day)
+                    output += ` ${day} 日`;
+                if (monthIsLeap)
+                    output += `（闰月）`;
+                output += `\n\n`;
+                output += `**年号西历范围**：${exactMatch.westernStart} ~ ${exactMatch.westernEnd}\n`;
+                output += `**年号总时长**：${exactMatch.duration}\n\n`;
+                output += `**估计第 ${year} 年对应的西历**：${computed.estimatedWesternStart} ~ ${computed.estimatedWesternEnd}\n\n`;
+                output += `> ${computed.note}\n\n`;
+                output += `---\n`;
+                output += `*数据来源：DILA 佛学规范资料库时间规范检索 (${DILA_SITE_URL})*`;
+                return {
+                    content: [{ type: "text", text: output }],
+                };
+            }
+            case "dila_search_era_names": {
+                const keyword = args?.keyword;
+                const dynasty = args?.dynasty;
+                const limit = args?.limit || 10;
+                if (!keyword) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "错误：缺少必需参数 keyword（搜索关键词）。",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                // Search by keyword using the era search endpoint
+                const results = await (0, dila_client_js_1.queryEraInfo)({
+                    keyword,
+                    dynasty,
+                });
+                const limited = results.slice(0, limit);
+                if (limited.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `未找到匹配 "${keyword}" 的年号或朝代信息。\n\n` +
+                                    (dynasty ? `限定朝代：${dynasty}\n` : "") +
+                                    `备选方案：手动访问 ${DILA_SITE_URL} 进行查询。`,
+                            },
+                        ],
+                    };
+                }
+                let output = `# 年号搜索结果：${keyword}\n\n`;
+                output += `共找到 ${results.length} 条结果`;
+                if (results.length > limit)
+                    output += `，以下显示前 ${limit} 条`;
+                output += `：\n\n`;
+                if (dynasty)
+                    output += `限定朝代：${dynasty}\n\n`;
+                output += formatEraResults(limited);
+                output += `\n\n---\n`;
+                output += `*数据来源：DILA 佛学规范资料库时间规范检索 (${DILA_SITE_URL})*`;
+                return {
+                    content: [{ type: "text", text: output }],
+                };
+            }
+            case "dila_lookup_ganzhi_year": {
+                const ganzhi = args?.ganzhi;
+                const dynasty = args?.dynasty;
+                if (!ganzhi) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: "错误：缺少必需参数 ganzhi（干支纪年，如：甲子、乙丑）。",
+                            },
+                        ],
+                        isError: true,
+                    };
+                }
+                const results = await (0, dila_client_js_1.queryGanzhi)({
+                    ganzhi,
+                    dynasty,
+                });
+                if (results.length === 0) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `未找到干支 "${ganzhi}" 对应的西历年份。\n\n` +
+                                    (dynasty ? `限定朝代：${dynasty}\n` : "") +
+                                    `备选方案：手动访问 ${DILA_SITE_URL} 进行查询。`,
+                            },
+                        ],
+                    };
+                }
+                let output = `# 干支 "${ganzhi}" 对应的西历年份\n\n`;
+                output += `共找到 ${results.length} 条记录：\n\n`;
+                if (dynasty)
+                    output += `限定朝代：${dynasty}\n\n`;
+                output += formatGanzhiResults(results);
+                output += `\n\n---\n`;
+                output += `*数据来源：DILA 佛学规范资料库时间规范检索 (${DILA_SITE_URL})*`;
+                return {
+                    content: [{ type: "text", text: output }],
+                };
+            }
+            default:
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `未知工具：${name}`,
+                        },
+                    ],
+                    isError: true,
+                };
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `查询出错：${errorMessage}\n\n备选方案：请手动访问 ${DILA_SITE_URL} 进行查询。`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ─── Main ───────────────────────────────────────────────────────────
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("DILA Time MCP Server started (stdio transport)");
+    console.error(`Data source: ${DILA_SITE_URL}`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAEA,wEAAmE;AACnE,wEAAiF;AACjF,iEAI4C;AAC5C,qDAM0B;AAE1B,MAAM,aAAa,GAAG,8CAA8C,CAAC;AAErE,uEAAuE;AAEvE,MAAM,KAAK,GAAW;IACpB;QACE,IAAI,EAAE,iCAAiC;QACvC,WAAW,EACT,4EAA4E;QAC9E,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,iBAAiB;iBAC/B;gBACD,QAAQ,EAAE;oBACR,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kBAAkB;iBAChC;gBACD,IAAI,EAAE;oBACJ,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,qBAAqB;iBACnC;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,eAAe;iBAC7B;gBACD,GAAG,EAAE;oBACH,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,eAAe;iBAC7B;gBACD,aAAa,EAAE;oBACb,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,mBAAmB;iBACjC;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,EAAE,UAAU,EAAE,MAAM,CAAC;SAC1C;KACF;IACD;QACE,IAAI,EAAE,uBAAuB;QAC7B,WAAW,EACT,8DAA8D;QAChE,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,uBAAuB;iBACrC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,WAAW;iBACzB;gBACD,KAAK,EAAE;oBACL,IAAI,EAAE,SAAS;oBACf,WAAW,EAAE,gBAAgB;iBAC9B;aACF;YACD,QAAQ,EAAE,CAAC,SAAS,CAAC;SACtB;KACF;IACD;QACE,IAAI,EAAE,yBAAyB;QAC/B,WAAW,EACT,sDAAsD;QACxD,WAAW,EAAE;YACX,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE;gBACV,MAAM,EAAE;oBACN,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,kBAAkB;iBAChC;gBACD,OAAO,EAAE;oBACP,IAAI,EAAE,QAAQ;oBACd,WAAW,EAAE,WAAW;iBACzB;aACF;YACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;SACrB;KACF;CACF,CAAC;AAEF,uEAAuE;AAEvE;;;;;;GAMG;AACH,SAAS,kBAAkB,CACzB,GAAc,EACd,UAAkB,EAClB,KAAc,EACd,GAAY,EACZ,WAAqB;IAQrB,+CAA+C;IAC/C,mDAAmD;IACnD,MAAM,UAAU,GAAG,GAAG,CAAC,YAAY,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,SAAS,GAAG,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC9C,MAAM,SAAS,GAAG,GAAG,CAAC,YAAY,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAE5D,MAAM,QAAQ,GAAG,GAAG,CAAC,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC3C,MAAM,OAAO,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1C,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAExD,8CAA8C;IAC9C,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAEzE,IAAI,UAAU,GAAG,CAAC,IAAI,UAAU,GAAG,SAAS,EAAE,CAAC;QAC7C,OAAO;YACL,gBAAgB,EAAE,EAAE;YACpB,cAAc,EAAE,EAAE;YAClB,qBAAqB,EAAE,EAAE;YACzB,mBAAmB,EAAE,EAAE;YACvB,IAAI,EAAE,OAAO,GAAG,CAAC,OAAO,QAAQ,SAAS,YAAY,UAAU,2BAA2B,SAAS,KAAK;SACzG,CAAC;IACJ,CAAC;IAED,oDAAoD;IACpD,wDAAwD;IACxD,MAAM,YAAY,GAAG,SAAS,GAAG,SAAS,GAAG,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC;IAC9D,MAAM,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,UAAU,CAAC;IAEtD,MAAM,OAAO,GAAG,CAAC,CAAS,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAE1E,IAAI,IAAI,GAAG,sBAAsB,GAAG,CAAC,OAAO,aAAa,GAAG,CAAC,YAAY,MAAM,GAAG,CAAC,UAAU,IAAI,GAAG,CAAC,QAAQ,gBAAgB,CAAC;IAC9H,IAAI,KAAK,EAAE,CAAC;QACV,IAAI,IAAI,yCAAyC,CAAC;QAClD,IAAI,IAAI,MAAM,UAAU,UAAU,OAAO,CAAC,YAAY,CAAC,MAAM,OAAO,CAAC,UAAU,CAAC,KAAK,CAAC;IACxF,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,IAAI,IAAI,sBAAsB,CAAC;IACjC,CAAC;IACD,IAAI,IAAI,iBAAiB,aAAa,UAAU,CAAC;IAEjD,OAAO;QACL,gBAAgB,EAAE,GAAG,CAAC,YAAY;QAClC,cAAc,EAAE,GAAG,CAAC,UAAU;QAC9B,qBAAqB,EAAE,GAAG,YAAY,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ;QACjH,mBAAmB,EAAE,GAAG,UAAU,IAAI,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,QAAQ;QAC3G,IAAI;KACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,SAAS,gBAAgB,CAAC,OAAoB;IAC5C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,4BAA4B,GAAG,aAAa,GAAG,QAAQ,CAAC;IACjE,CAAC;IAED,OAAO,OAAO;SACX,GAAG,CACF,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,IAAI;QACvD,WAAW,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,UAAU,IAAI;QAC/C,SAAS,CAAC,CAAC,QAAQ,EAAE,CACxB;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,SAAS,mBAAmB,CAAC,OAAuB;IAClD,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACzB,OAAO,8BAA8B,GAAG,aAAa,GAAG,QAAQ,CAAC;IACnE,CAAC;IAED,OAAO,OAAO;SACX,GAAG,CACF,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CACP,GAAG,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,OAAO,IAAI,CAAC,CAAC,OAAO,MAAM,CAAC,CAAC,OAAO,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,IAAI,GAAG,GAAG,CAAC,CAAC,CAAC,EAAE,IAAI;QAC1F,WAAW,CAAC,CAAC,YAAY,MAAM,CAAC,CAAC,UAAU,EAAE,CAChD;SACA,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,uEAAuE;AAEvE,MAAM,MAAM,GAAG,IAAI,iBAAM,CACvB;IACE,IAAI,EAAE,2BAA2B;IACjC,OAAO,EAAE,OAAO;CACjB,EACD;IACE,YAAY,EAAE;QACZ,KAAK,EAAE,EAAE;KACV;CACF,CACF,CAAC;AAEF,aAAa;AACb,MAAM,CAAC,iBAAiB,CAAC,iCAAsB,EAAE,KAAK,IAAI,EAAE;IAC1D,OAAO,EAAE,KAAK,EAAE,CAAC;AACnB,CAAC,CAAC,CAAC;AAEH,oBAAoB;AACpB,MAAM,CAAC,iBAAiB,CAAC,gCAAqB,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE;IAChE,MAAM,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAEjD,IAAI,CAAC;QACH,QAAQ,IAAI,EAAE,CAAC;YACb,KAAK,iCAAiC,CAAC,CAAC,CAAC;gBACvC,MAAM,OAAO,GAAG,IAAI,EAAE,OAAiB,CAAC;gBACxC,MAAM,OAAO,GAAG,IAAI,EAAE,QAAkB,CAAC;gBACzC,MAAM,IAAI,GAAG,IAAI,EAAE,IAAc,CAAC;gBAClC,MAAM,KAAK,GAAG,IAAI,EAAE,KAA2B,CAAC;gBAChD,MAAM,GAAG,GAAG,IAAI,EAAE,GAAyB,CAAC;gBAC5C,MAAM,WAAW,GAAG,IAAI,EAAE,aAAoC,CAAC;gBAE/D,IAAI,CAAC,OAAO,IAAI,CAAC,OAAO,IAAI,CAAC,IAAI,EAAE,CAAC;oBAClC,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,mDAAmD;6BAC1D;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,qCAAqC;gBACrC,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAY,EAAC;oBACjC,OAAO;oBACP,OAAO;iBACR,CAAC,CAAC;gBAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,gBAAgB,OAAO,SAAS,OAAO,QAAQ;oCACnD,OAAO;oCACP,oBAAoB;oCACpB,sCAAsC;oCACtC,WAAW,aAAa,KAAK;6BAChC;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,sEAAsE;gBACtE,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAC7B,CAAC,CAAC,EAAE,EAAE,CACJ,CAAC,CAAC,OAAO,KAAK,OAAO;oBACrB,CAAC,CAAC,CAAC,OAAO,KAAK,OAAO;wBACpB,CAAC,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC;wBAC3B,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CACjC,IAAI,OAAO,CAAC,CAAC,CAAC,CAAC;gBAEhB,MAAM,QAAQ,GAAG,kBAAkB,CACjC,UAAU,EACV,IAAI,EACJ,KAAK,EACL,GAAG,EACH,WAAW,CACZ,CAAC;gBAEF,IAAI,MAAM,GAAG,oBAAoB,CAAC;gBAClC,MAAM,IAAI,UAAU,UAAU,CAAC,OAAO,IAAI,CAAC;gBAC3C,MAAM,IAAI,UAAU,UAAU,CAAC,OAAO,IAAI,CAAC;gBAC3C,MAAM,IAAI,UAAU,UAAU,CAAC,OAAO,IAAI,CAAC;gBAC3C,MAAM,IAAI,OAAO,IAAI,MAAM,CAAC;gBAC5B,IAAI,KAAK;oBAAE,MAAM,IAAI,IAAI,KAAK,IAAI,CAAC;gBACnC,IAAI,GAAG;oBAAE,MAAM,IAAI,IAAI,GAAG,IAAI,CAAC;gBAC/B,IAAI,WAAW;oBAAE,MAAM,IAAI,MAAM,CAAC;gBAClC,MAAM,IAAI,MAAM,CAAC;gBACjB,MAAM,IAAI,cAAc,UAAU,CAAC,YAAY,MAAM,UAAU,CAAC,UAAU,IAAI,CAAC;gBAC/E,MAAM,IAAI,aAAa,UAAU,CAAC,QAAQ,MAAM,CAAC;gBACjD,MAAM,IAAI,SAAS,IAAI,aAAa,QAAQ,CAAC,qBAAqB,MAAM,QAAQ,CAAC,mBAAmB,MAAM,CAAC;gBAC3G,MAAM,IAAI,KAAK,QAAQ,CAAC,IAAI,MAAM,CAAC;gBACnC,MAAM,IAAI,OAAO,CAAC;gBAClB,MAAM,IAAI,6BAA6B,aAAa,IAAI,CAAC;gBAEzD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC1C,CAAC;YACJ,CAAC;YAED,KAAK,uBAAuB,CAAC,CAAC,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,EAAE,OAAiB,CAAC;gBACxC,MAAM,OAAO,GAAG,IAAI,EAAE,OAA6B,CAAC;gBACpD,MAAM,KAAK,GAAI,IAAI,EAAE,KAAgB,IAAI,EAAE,CAAC;gBAE5C,IAAI,CAAC,OAAO,EAAE,CAAC;oBACb,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,2BAA2B;6BAClC;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,kDAAkD;gBAClD,MAAM,OAAO,GAAG,MAAM,IAAA,6BAAY,EAAC;oBACjC,OAAO;oBACP,OAAO;iBACR,CAAC,CAAC;gBAEH,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;gBAExC,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,UAAU,OAAO,iBAAiB;oCACtC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oCACpC,aAAa,aAAa,QAAQ;6BACrC;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,IAAI,MAAM,GAAG,YAAY,OAAO,MAAM,CAAC;gBACvC,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,MAAM,CAAC;gBACtC,IAAI,OAAO,CAAC,MAAM,GAAG,KAAK;oBAAE,MAAM,IAAI,UAAU,KAAK,IAAI,CAAC;gBAC1D,MAAM,IAAI,OAAO,CAAC;gBAClB,IAAI,OAAO;oBAAE,MAAM,IAAI,QAAQ,OAAO,MAAM,CAAC;gBAC7C,MAAM,IAAI,gBAAgB,CAAC,OAAO,CAAC,CAAC;gBACpC,MAAM,IAAI,WAAW,CAAC;gBACtB,MAAM,IAAI,6BAA6B,aAAa,IAAI,CAAC;gBAEzD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC1C,CAAC;YACJ,CAAC;YAED,KAAK,yBAAyB,CAAC,CAAC,CAAC;gBAC/B,MAAM,MAAM,GAAG,IAAI,EAAE,MAAgB,CAAC;gBACtC,MAAM,OAAO,GAAG,IAAI,EAAE,OAA6B,CAAC;gBAEpD,IAAI,CAAC,MAAM,EAAE,CAAC;oBACZ,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,iCAAiC;6BACxC;yBACF;wBACD,OAAO,EAAE,IAAI;qBACd,CAAC;gBACJ,CAAC;gBAED,MAAM,OAAO,GAAG,MAAM,IAAA,4BAAW,EAAC;oBAChC,MAAM;oBACN,OAAO;iBACR,CAAC,CAAC;gBAEH,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACzB,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAM;gCACZ,IAAI,EAAE,UAAU,MAAM,gBAAgB;oCACpC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;oCACpC,aAAa,aAAa,QAAQ;6BACrC;yBACF;qBACF,CAAC;gBACJ,CAAC;gBAED,IAAI,MAAM,GAAG,SAAS,MAAM,eAAe,CAAC;gBAC5C,MAAM,IAAI,OAAO,OAAO,CAAC,MAAM,WAAW,CAAC;gBAC3C,IAAI,OAAO;oBAAE,MAAM,IAAI,QAAQ,OAAO,MAAM,CAAC;gBAC7C,MAAM,IAAI,mBAAmB,CAAC,OAAO,CAAC,CAAC;gBACvC,MAAM,IAAI,WAAW,CAAC;gBACtB,MAAM,IAAI,6BAA6B,aAAa,IAAI,CAAC;gBAEzD,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;iBAC1C,CAAC;YACJ,CAAC;YAED;gBACE,OAAO;oBACL,OAAO,EAAE;wBACP;4BACE,IAAI,EAAE,MAAM;4BACZ,IAAI,EAAE,QAAQ,IAAI,EAAE;yBACrB;qBACF;oBACD,OAAO,EAAE,IAAI;iBACd,CAAC;QACN,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,YAAY,GAChB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACzD,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,QAAQ,YAAY,kBAAkB,aAAa,QAAQ;iBAClE;aACF;YACD,OAAO,EAAE,IAAI;SACd,CAAC;IACJ,CAAC;AACH,CAAC,CAAC,CAAC;AAEH,uEAAuE;AAEvE,KAAK,UAAU,IAAI;IACjB,MAAM,SAAS,GAAG,IAAI,+BAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,gDAAgD,CAAC,CAAC;IAChE,OAAO,CAAC,KAAK,CAAC,gBAAgB,aAAa,EAAE,CAAC,CAAC;AACjD,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,87 @@
+{
+  "name": "@dhcckb/mcp-server-dila-time",
+  "version": "1.0.0",
+  "description": "MCP Server for Chinese-Western calendar conversion using DILA Buddhist Studies Time Authority Database",
+  "main": "dist/index.js",
+  "bin": {
+    "mcp-server-dila-time": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "chinese-calendar",
+    "western-calendar",
+    "dila",
+    "buddhist-studies",
+    "time-authority",
+    "era-conversion",
+    "ganzhi",
+    "sexagenary-cycle"
+  ],
+  "author": "DHCCKB",
+  "license": "MIT",
+  "engines": {
+    "node": ">=18"
+  },
+  "files": [
+    "dist/",
+    "README.md"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.17.0",
+    "axios": "^1.7.0",
+    "cheerio": "^1.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0"
+  },
+  "mcp": {
+    "tools": [
+      {
+        "name": "dila_convert_chinese_to_western",
+        "description": "将中历日期转换为西历日期。输入朝代、年号、年份、月份（可选）、日期（可选），返回对应的西历年月日或年份范围。基于 DILA 佛学规范资料库权威数据。",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "dynasty": { "type": "string", "description": "朝代名称，如：唐、宋、明、清等" },
+            "era_name": { "type": "string", "description": "年号名称，如：贞观、康熙、乾隆等" },
+            "year": { "type": "integer", "description": "年号纪年（数字），如 3 代表贞观三年" },
+            "month": { "type": "integer", "description": "农历月份（1-12），可选" },
+            "day": { "type": "integer", "description": "农历日期（1-30），可选" },
+            "month_is_leap": { "type": "boolean", "description": "是否为闰月，可选，默认 false" }
+          },
+          "required": ["dynasty", "era_name", "year"]
+        }
+      },
+      {
+        "name": "dila_search_era_names",
+        "description": "根据关键词搜索朝代或年号信息。用于用户在不确定完整年号名称时进行模糊匹配。返回匹配的年号列表及其所属朝代和起止西历年份。",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "keyword": { "type": "string", "description": "搜索关键词，可以是朝代名或年号名的部分文字" },
+            "dynasty": { "type": "string", "description": "限定朝代范围，可选" },
+            "limit": { "type": "integer", "description": "返回结果数量上限，默认 10" }
+          },
+          "required": ["keyword"]
+        }
+      },
+      {
+        "name": "dila_lookup_ganzhi_year",
+        "description": "通过干支纪年查找对应的西历年份。输入干支组合（如：甲子、乙丑）和可选的朝代限定，返回对应的西历年份列表。",
+        "inputSchema": {
+          "type": "object",
+          "properties": {
+            "ganzhi": { "type": "string", "description": "干支纪年，如：甲子、乙丑、戊戌等" },
+            "dynasty": { "type": "string", "description": "限定朝代范围，可选" }
+          },
+          "required": ["ganzhi"]
+        }
+      }
+    ]
+  }
+}