mingpan 0.1.2 → 0.1.4

package/dist/shared/logger.js.map

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

package/dist/tools/baziTools.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 八字命理 MCP 工具
+ *
+ * 工具列表：
+ * - bazi_basic      基礎排盤（四柱、藏干、十神、五行力量）
+ * - bazi_dayun      大運列表
+ * - bazi_liunian    流年列表
+ * - bazi_liuyue     流月列表（節氣月）
+ * - bazi_liuri      流日列表
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerBaziTools(server: McpServer): void;
+//# sourceMappingURL=baziTools.d.ts.map

package/dist/tools/baziTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baziTools.d.ts","sourceRoot":"","sources":["../../src/tools/baziTools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAmCzE,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAsXzD"}

package/dist/tools/baziTools.js

@@ -0,0 +1,331 @@
+"use strict";
+/**
+ * 八字命理 MCP 工具
+ *
+ * 工具列表：
+ * - bazi_basic      基礎排盤（四柱、藏干、十神、五行力量）
+ * - bazi_dayun      大運列表
+ * - bazi_liunian    流年列表
+ * - bazi_liuyue     流月列表（節氣月）
+ * - bazi_liuri      流日列表
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerBaziTools = registerBaziTools;
+const zod_1 = require("zod");
+const BaziService_1 = require("../services/bazi/BaziService");
+const LiuNianCalculator_1 = require("../services/bazi/calculators/LiuNianCalculator");
+const DaYunCalculator_1 = require("../services/bazi/calculators/DaYunCalculator");
+const LuckCycleCalculator_1 = require("../services/bazi/calculators/LuckCycleCalculator");
+const LiuYueCalculator_1 = require("../services/bazi/calculators/LiuYueCalculator");
+const LiuRiCalculator_1 = require("../services/bazi/calculators/LiuRiCalculator");
+const fortuneTextRenderer_1 = require("../output/fortuneTextRenderer");
+const listTextRenderer_1 = require("../output/listTextRenderer");
+const schemas_1 = require("./schemas");
+const baziService = new BaziService_1.BaziService({ debug: false });
+const countField = zod_1.z.number().int().min(1).max(12).optional().default(10).describe('Number of periods to display (default 10)');
+const ganzhiYearField = zod_1.z.union([
+    zod_1.z.string().describe("GanZhi year like '乙巳'"),
+    zod_1.z.number().int().min(1900).max(2100).describe('Gregorian year like 2025'),
+]);
+function registerBaziTools(server) {
+    server.registerTool('bazi_basic', {
+        title: '八字基礎排盤',
+        description: `計算八字四柱（基礎排盤）。
+
+輸入出生時間，返回由節氣與曆法精確推算的確定性結果：
+- 年柱、月柱、日柱、時柱干支（含節氣月邊界、晚子時處理）及六十甲子納音
+- 天干十神與藏干十神（各支藏干逐個標注，※為本氣）
+- 十二長生（自坐）
+- 命宮（三命通會子平起法）、胎元（月干進一支進三）
+- 日柱旬空
+- 公曆/農曆出生日期對照
+
+時區說明：默認按北京時間排盤；海外出生者請提供 timezone 參數，
+系統將換算為北京時間後計算；可提供 longitude 做真太陽時校正。
+
+定位說明：本工具只負責確定性排盤（干支、藏干、十神）。
+五行強弱、格局、用神、神煞等屬解讀層，無權威統一口徑，
+請由 AI 依據四柱自行分析。
+
+大運/流年/流月/流日請使用對應列表工具。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+            gender: normalized.gender,
+            longitude: normalized.longitude,
+        });
+        const birthDate = new Date(normalized.year, normalized.month - 1, normalized.day, normalized.hour, normalized.minute);
+        const trueSolarTime = result.birthInfo?.trueSolarTime instanceof Date
+            ? result.birthInfo.trueSolarTime
+            : undefined;
+        const text = (0, fortuneTextRenderer_1.renderBaziText)({ bazi: result, gender: normalized.gender, birthDate, trueSolarTime }, { includePersonal: false, includeLocation: !!normalized.longitude });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + text;
+    }));
+    server.registerTool('bazi_dayun', {
+        title: '八字大運列表',
+        description: `八字大運列表。
+
+返回命主一生的大運週期（十年一運）：
+- 大運干支
+- 起止虛歲
+- 對應公曆年份
+- 起運方向（順行/逆行）
+- 起運年齡
+
+用於了解人生各階段的運勢大框架。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            count: countField,
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_dayun', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const direction = LuckCycleCalculator_1.LuckCycleCalculator.calLuckySequence(normalized.gender, result.chart.year.stem) === 'forward' ? '顺行' : '逆行';
+        const startAge = daYunList.length > 0 ? daYunList[0].startAge : 1;
+        const startYear = normalized.year + startAge - 1;
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            direction,
+            startAge,
+            startYear,
+        };
+        return (0, listTextRenderer_1.renderBaziDaYunList)(daYunList.slice(0, args.count), options);
+    }));
+    server.registerTool('bazi_liunian', {
+        title: '八字流年列表',
+        description: `八字流年列表。
+
+返回指定年份範圍內的流年信息：
+- 公曆年份
+- 干支年
+- 虛歲
+- 所屬大運
+
+用於分析多年運勢趨勢。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            startYear: zod_1.z.number().int().min(1900).max(2100).describe('Start year for the range'),
+            endYear: zod_1.z.number().int().min(1900).max(2100).describe('End year for the range'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liunian', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, args.startYear, args.endYear);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            startYear: args.startYear,
+            endYear: args.endYear,
+            daYunList,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuNianList)(liuNianList, options);
+    }));
+    server.registerTool('bazi_liuyue', {
+        title: '八字流月列表',
+        description: `八字流月列表。
+
+重要：八字流月使用【節氣月】，非農曆月！
+- 以節氣為邊界（立春起算）
+- 寅月（正月）從立春開始，約2月4日
+- 丑月（臘月）跨越公曆年界
+
+返回指定年份的12個月運勢：
+- 干支月
+- 節氣起止
+- 公曆日期範圍
+
+用於規劃年度活動時機。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            ganzhiYear: ganzhiYearField.describe("The year to query (either GanZhi string like '乙巳' or Gregorian year like 2025)"),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liuyue', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const { year: gregorianYear, ganzhi: ganzhiYear } = (0, schemas_1.parseGanzhiYear)(args.ganzhiYear);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(gregorianYear);
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const targetAge = gregorianYear - normalized.year + 1;
+        let currentDaYun;
+        const matchedDaYun = daYunList.find(dy => targetAge >= dy.startAge && targetAge <= dy.endAge);
+        if (matchedDaYun) {
+            currentDaYun = {
+                stem: matchedDaYun.stem,
+                branch: matchedDaYun.branch,
+                startAge: matchedDaYun.startAge,
+                endAge: matchedDaYun.endAge,
+            };
+        }
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, gregorianYear, gregorianYear);
+        let currentLiuNian;
+        if (liuNianList.length > 0) {
+            const ln = liuNianList[0];
+            currentLiuNian = { stem: ln.stem, branch: ln.branch, age: ln.age };
+        }
+        const calculator = new LiuYueCalculator_1.LiuYueCalculator();
+        const liuYueList = calculator.calculateLiuYue(yearStem, yearBranch, (result.basic?.dayMasterElement || '木'), (result.traditional?.yongShen?.yongShen || []), {
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+        }, gregorianYear);
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            ganzhiYear,
+            gregorianYear,
+            currentDaYun,
+            currentLiuNian,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuYueList)(liuYueList, options);
+    }));
+    server.registerTool('bazi_liuri', {
+        title: '八字流日列表',
+        description: `八字流日列表。
+
+返回指定月份內的每日運勢（含上下文）：
+- 當前大運、流年、流月資訊
+- 公曆日期
+- 干支日
+
+用於精細的日期選擇。`,
+        inputSchema: {
+            ...schemas_1.baseBirthInfoFields,
+            ganzhiYear: ganzhiYearField.describe("The year of the month (GanZhi string or Gregorian year)"),
+            ganzhiMonth: zod_1.z.union([
+                zod_1.z.string().describe("GanZhi month like '丙寅' (month 1 = 寅月)"),
+                zod_1.z.number().int().min(1).max(12).describe('Month number (1=寅月, 2=卯月, ..., 12=丑月)'),
+            ]).describe('The month to query (either GanZhi string or month number 1-12)'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('bazi_liuri', async () => {
+        const { normalized } = (0, schemas_1.normalizeBirthInfo)(args);
+        const { year: gregorianYear, ganzhi: ganzhiYear } = (0, schemas_1.parseGanzhiYear)(args.ganzhiYear);
+        const monthNum = (0, schemas_1.parseGanzhiMonth)(args.ganzhiMonth);
+        const result = await baziService.calculate({
+            year: normalized.year, month: normalized.month, day: normalized.day,
+            hour: normalized.hour, minute: normalized.minute,
+            gender: normalized.gender, longitude: normalized.longitude,
+        });
+        if (!result.chart || !result.birthInfo) {
+            throw new Error('Failed to calculate BaZi chart');
+        }
+        const { stem: yearStem, branch: yearBranch } = (0, schemas_1.getYearStemBranch)(gregorianYear);
+        const { stem: monthStem, branch: monthBranch } = (0, schemas_1.getMonthStemBranch)(gregorianYear, monthNum);
+        const daYunList = DaYunCalculator_1.DaYunCalculator.calculate(result.chart, result.birthInfo, normalized.gender, { startYear: normalized.year, endYear: normalized.year + 100 });
+        const targetAge = gregorianYear - normalized.year + 1;
+        let currentDaYun;
+        const matchedDaYun = daYunList.find(dy => targetAge >= dy.startAge && targetAge <= dy.endAge);
+        if (matchedDaYun) {
+            currentDaYun = {
+                stem: matchedDaYun.stem,
+                branch: matchedDaYun.branch,
+                startAge: matchedDaYun.startAge,
+                endAge: matchedDaYun.endAge,
+            };
+        }
+        const liuNianList = LiuNianCalculator_1.LiuNianCalculator.calculate(result.chart, normalized.year, gregorianYear, gregorianYear);
+        let currentLiuNian;
+        if (liuNianList.length > 0) {
+            const ln = liuNianList[0];
+            currentLiuNian = { stem: ln.stem, branch: ln.branch, age: ln.age };
+        }
+        const currentLiuYue = {
+            stem: monthStem,
+            branch: monthBranch,
+            month: monthNum,
+        };
+        // Calculate LiuRi
+        const liuRiCalc = new LiuRiCalculator_1.LiuRiCalculator();
+        const liuRiList = liuRiCalc.calculateLiuRi(monthStem, monthBranch, yearStem, yearBranch, (result.basic?.dayMasterElement || '木'), (result.traditional?.yongShen?.yongShen || []), gregorianYear, monthNum);
+        // Get the first and last date from the calculated list
+        const startDate = liuRiList.length > 0 ? liuRiList[0].date : new Date();
+        const endDate = liuRiList.length > 0 ? liuRiList[liuRiList.length - 1].date : new Date();
+        const options = {
+            name: normalized.name,
+            birthYear: normalized.year,
+            birthMonth: normalized.month,
+            birthDay: normalized.day,
+            birthHour: normalized.hour,
+            birthMinute: normalized.minute,
+            gender: normalized.gender,
+            dayMaster: result.chart.day.stem,
+            yearPillar: { stem: result.chart.year.stem, branch: result.chart.year.branch },
+            monthPillar: { stem: result.chart.month.stem, branch: result.chart.month.branch },
+            dayPillar: { stem: result.chart.day.stem, branch: result.chart.day.branch },
+            hourPillar: { stem: result.chart.hour.stem, branch: result.chart.hour.branch },
+            ganzhiMonth: monthStem + monthBranch,
+            ganzhiYear,
+            gregorianYear,
+            startDate,
+            endDate,
+            currentDaYun,
+            currentLiuNian,
+            currentLiuYue,
+        };
+        return (0, listTextRenderer_1.renderBaziLiuRiList)(liuRiList, options);
+    }));
+}
+//# sourceMappingURL=baziTools.js.map

package/dist/tools/baziTools.js.map

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

package/dist/tools/divinationTools.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 占卜類 MCP 工具：六爻、梅花易數、大六壬
+ *
+ * 設計原則：占卜工具的時間參數為「起卦/起課時間」，
+ * 節氣、干支等曆法量一律由 MCP 自動推得（LLM 手推干支極易出錯）。
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerDivinationTools(server: McpServer): void;
+//# sourceMappingURL=divinationTools.d.ts.map

package/dist/tools/divinationTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"divinationTools.d.ts","sourceRoot":"","sources":["../../src/tools/divinationTools.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2M/D"}

package/dist/tools/divinationTools.js

@@ -0,0 +1,209 @@
+"use strict";
+/**
+ * 占卜類 MCP 工具：六爻、梅花易數、大六壬
+ *
+ * 設計原則：占卜工具的時間參數為「起卦/起課時間」，
+ * 節氣、干支等曆法量一律由 MCP 自動推得（LLM 手推干支極易出錯）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDivinationTools = registerDivinationTools;
+const zod_1 = require("zod");
+const LiuyaoService_1 = require("../services/liuyao/LiuyaoService");
+const liuyaoTextRenderer_1 = require("../output/liuyaoTextRenderer");
+const MeihuaService_1 = require("../services/meihua/MeihuaService");
+const meihuaTextRenderer_1 = require("../output/meihuaTextRenderer");
+const DaliurenService_1 = require("../services/daliuren/DaliurenService");
+const daliurenTextRenderer_1 = require("../output/daliurenTextRenderer");
+const schemas_1 = require("./schemas");
+const liuyaoService = new LiuyaoService_1.LiuyaoService();
+const meihuaService = new MeihuaService_1.MeihuaService();
+const yaoValue = zod_1.z.union([zod_1.z.literal(6), zod_1.z.literal(7), zod_1.z.literal(8), zod_1.z.literal(9)]);
+function registerDivinationTools(server) {
+    // ============= 六爻 =============
+    server.registerTool('liuyao_basic', {
+        title: '六爻排盤',
+        description: `六爻排盤（基礎排盤）。
+
+輸入六個爻值和起卦時間，返回完整的六爻盤面：
+- 本卦/變卦（含卦名、卦宮、五行）
+- 六爻納甲（每爻地支及五行）
+- 六親（父母/兄弟/子孫/妻財/官鬼）
+- 六神（青龍/朱雀/勾陳/螣蛇/白虎/玄武）
+- 世應位置
+- 動爻標註
+- 日干支、月建、旬空
+
+爻值說明：
+- 6 = 老陰（動爻，陰變陽）
+- 7 = 少陽（靜爻，陽）
+- 8 = 少陰（靜爻，陰）
+- 9 = 老陽（動爻，陽變陰）
+
+輸入順序：自下而上（初爻到上爻）
+起卦時間默認北京時間，可提供 timezone 换算。
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            yaoValues: zod_1.z.tuple([yaoValue, yaoValue, yaoValue, yaoValue, yaoValue, yaoValue])
+                .describe('六個爻值（自下而上，初爻到上爻）。6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動)'),
+            ...schemas_1.birthTimeFields,
+        },
+    }, async (args) => (0, schemas_1.textResult)('liuyao_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = liuyaoService.calculate({
+            yaoValues: args.yaoValues,
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            isLunar: false,
+        });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, liuyaoTextRenderer_1.renderLiuyaoText)(result);
+    }));
+    // ============= 梅花易數 =============
+    server.registerTool('meihua_basic', {
+        title: '梅花易數排盤',
+        description: `梅花易數排盤（基礎排盤）。
+
+支持兩種起卦方式：
+1. 時間起卦（method='time'）：根據農曆年月日時起卦
+2. 數字起卦（method='number'）：根據兩個數字起卦
+
+返回完整的梅花盤面：
+- 本卦/變卦/互卦
+- 上卦/下卦（含卦象、五行）
+- 動爻位置
+- 體用分析（體卦、用卦、五行生剋關係）
+- 起卦數據詳情
+
+時間起卦算法（農曆）：
+- 上卦 = (年支序數 + 月 + 日) % 8
+- 下卦 = (年支序數 + 月 + 日 + 時辰序數) % 8
+- 動爻 = (年支序數 + 月 + 日 + 時辰序數) % 6
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            method: zod_1.z.enum(['time', 'number']).describe("起卦方式：time=時間起卦，number=數字起卦"),
+            year: schemas_1.yearField.optional().describe('起卦年份（公曆，time 模式必填）'),
+            month: schemas_1.monthField.optional().describe('起卦月份（1-12，time 模式必填）'),
+            day: schemas_1.dayField.optional().describe('起卦日期（1-31，time 模式必填）'),
+            hour: schemas_1.hourField.optional().describe('起卦時辰（0-23，time 模式必填）'),
+            isLunar: zod_1.z.boolean().optional().default(false).describe('輸入是否為農曆，默認 false'),
+            timezone: zod_1.z.string().optional().describe('IANA 時區名（time 模式，默認北京時間）'),
+            upperNumber: zod_1.z.number().int().min(1).optional().describe('上卦數（number 模式必填）'),
+            lowerNumber: zod_1.z.number().int().min(1).optional().describe('下卦數（number 模式必填）'),
+            yaoNumber: zod_1.z.number().int().min(1).optional().describe('動爻數（可選，默認用上下卦數之和）'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('meihua_basic', async () => {
+        let year = args.year;
+        let month = args.month;
+        let day = args.day;
+        let hour = args.hour;
+        let isLunar = args.isLunar;
+        // 時間模式：入口層完成時區歸一化後再交給服務層
+        if (args.method === 'time' && year !== undefined && month !== undefined && day !== undefined && hour !== undefined) {
+            const { normalized } = (0, schemas_1.normalizeBirthInfo)({
+                year, month, day, hour,
+                isLunar,
+                timezone: args.timezone,
+            });
+            year = normalized.year;
+            month = normalized.month;
+            day = normalized.day;
+            hour = normalized.hour;
+            isLunar = false;
+        }
+        const result = meihuaService.calculate({
+            method: args.method,
+            year,
+            month,
+            day,
+            hour,
+            isLunar,
+            upperNumber: args.upperNumber,
+            lowerNumber: args.lowerNumber,
+            yaoNumber: args.yaoNumber,
+        });
+        return (0, meihuaTextRenderer_1.renderMeihuaText)(result);
+    }));
+    // ============= 大六壬 =============
+    server.registerTool('daliuren_basic', {
+        title: '大六壬排盤',
+        description: `大六壬排盤（基礎排盤）。
+
+大六壬是中國古老三大占卜術之一，與奇門遁甲、太乙神數並稱三式。
+
+【推薦用法】直接輸入公曆起課時間，系統自動推得節氣、月將、日干支、時干支：
+- year/month/day/hour（+ 可選 minute、timezone、isLunar）
+
+【專家模式】也可顯式指定曆法量（一般無需使用）：
+- jieqi：節氣（如：立春、驚蟄，簡繁均可）
+- dayGanZhi / hourGanZhi：完整干支（如：甲子、乙丑）
+
+返回完整的六壬盤面：
+- 天地盤（月將加時辰起盤）
+- 四課（日干支推演）
+- 三傳（九宗門推演：賊尅、比用、涉害、遙尅、昴星、別責、八專、伏吟、返吟）
+- 十二天將（貴人、螣蛇、朱雀、六合、勾陳、青龍、天空、白虎、太常、玄武、太陰、天后）
+- 格局判斷
+- 神煞（日馬、月馬、丁馬、華蓋、閃電）
+
+本工具只負責排盤，斷課解讀交給 Agent。
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            // 推薦：時間輸入
+            year: schemas_1.yearField.optional().describe('起課年份（公曆，推薦用法）'),
+            month: schemas_1.monthField.optional().describe('起課月份（1-12）'),
+            day: schemas_1.dayField.optional().describe('起課日期（1-31）'),
+            hour: schemas_1.hourField.optional().describe('起課時辰（0-23）'),
+            minute: zod_1.z.number().int().min(0).max(59).optional().describe('分鐘（0-59），默認 0'),
+            isLunar: zod_1.z.boolean().optional().default(false).describe('輸入是否為農曆，默認 false'),
+            timezone: zod_1.z.string().optional().describe('IANA 時區名（默認北京時間）'),
+            // 專家模式：顯式曆法量
+            jieqi: zod_1.z.string().optional().describe('【專家模式】節氣（如：立春、驚蟄，簡繁均可）'),
+            lunarMonth: zod_1.z.number().int().min(1).max(12).optional().describe('【專家模式】農曆月份（1-12）'),
+            dayGanZhi: zod_1.z.string().optional().describe('【專家模式】日干支（如：甲子、乙丑）'),
+            hourGanZhi: zod_1.z.string().optional().describe('【專家模式】時干支（如：甲子、乙丑）'),
+            guirenMethod: zod_1.z.union([zod_1.z.literal(0), zod_1.z.literal(1)]).optional().default(0).describe('貴人起法：0=標準, 1=另一種'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('daliuren_basic', async () => {
+        const daliurenService = new DaliurenService_1.DaliurenService();
+        const guirenMethod = args.guirenMethod;
+        // 推薦路徑：由時間自動推節氣/月將/干支
+        const hasTime = args.year !== undefined && args.month !== undefined && args.day !== undefined && args.hour !== undefined;
+        if (hasTime) {
+            const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)({
+                year: args.year,
+                month: args.month,
+                day: args.day,
+                hour: args.hour,
+                minute: args.minute,
+                isLunar: args.isLunar,
+                timezone: args.timezone,
+            });
+            const result = daliurenService.calculateFromTime({
+                year: normalized.year,
+                month: normalized.month,
+                day: normalized.day,
+                hour: normalized.hour,
+                minute: normalized.minute,
+                guirenMethod,
+            });
+            return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, daliurenTextRenderer_1.renderDaliurenText)(result);
+        }
+        // 專家模式：顯式曆法量
+        if (args.jieqi && args.lunarMonth !== undefined && args.dayGanZhi && args.hourGanZhi) {
+            const result = daliurenService.calculate({
+                jieqi: args.jieqi,
+                lunarMonth: args.lunarMonth,
+                dayGanZhi: args.dayGanZhi,
+                hourGanZhi: args.hourGanZhi,
+                guirenMethod,
+            });
+            return (0, daliurenTextRenderer_1.renderDaliurenText)(result);
+        }
+        throw new Error('輸入不完整：請提供起課時間（year/month/day/hour），或完整專家參數（jieqi + lunarMonth + dayGanZhi + hourGanZhi）');
+    }));
+}
+//# sourceMappingURL=divinationTools.js.map

package/dist/tools/divinationTools.js.map

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

package/dist/tools/qimenTools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 奇門遁甲 MCP 工具
+ *
+ * 工具列表：
+ * - qimen_basic     基礎排盤（九宮布局、三奇六儀、八門九星八神、格局檢測）
+ * - qimen_yongshen  用神分析（按事類，僅確定性信息）
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerQimenTools(server: McpServer): void;
+//# sourceMappingURL=qimenTools.d.ts.map

package/dist/tools/qimenTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qimenTools.d.ts","sourceRoot":"","sources":["../../src/tools/qimenTools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmH1D"}