analyze_xiaoliuren

Analyzes XiaoLiuRen divination guidance for specific dates and times using traditional Chinese six-spirit fortune telling methods with solar or lunar calendar support.

Instructions

分析指定日期时辰的小六壬指导意见

Input Schema

TableJSON Schema

Name	Required	Description	Default
`date`	Yes	日期，格式：YYYY-MM-DD
`time`	Yes	时辰，格式：HH:MM 或者传统时辰名称（如：子时、丑时等）
`calendar_type`	Yes	日历类型：solar=阳历，lunar=农历	solar

Implementation Reference

index.js:91-179 (handler)

Core handler function for the 'analyze_xiaoliuren' tool. Parses date and time inputs, converts to lunar calendar using js-calendar-converter, computes the Xiao Liu Ren divination based on lunar month, day, and hour, generates detailed output with process, result, and advice.

  async analyzeXiaoLiuRen(date, time, calendar_type) {
    try {
      // 解析日期
      const dateMatch = date.match(/^(\d{4})-(\d{1,2})-(\d{1,2})$/);
      if (!dateMatch) {
        throw new Error('日期格式错误，请使用 YYYY-MM-DD 格式');
      }

      const year = parseInt(dateMatch[1]);
      const month = parseInt(dateMatch[2]);
      const day = parseInt(dateMatch[3]);

      let lunarDate;

      if (calendar_type === 'solar') {
        // 阳历转农历 - 使用专业库
        const result = calendar.solar2lunar(year, month, day);
        lunarDate = {
          year: result.lYear,
          month: result.lMonth,
          day: result.lDay,
          isLeap: result.isLeap,
          yearGanZhi: result.gzYear,
          monthGanZhi: result.gzMonth,
          dayGanZhi: result.gzDay,
          lunarMonthName: result.IMonthCn,
          lunarDayName: result.IDayCn,
          term: result.Term || ''
        };
      } else {
        // 如果是农历，先转为阳历再转回农历获得完整信息
        const solarResult = calendar.lunar2solar(year, month, day);
        const lunarResult = calendar.solar2lunar(solarResult.cYear, solarResult.cMonth, solarResult.cDay);
        lunarDate = {
          year: year,
          month: month,
          day: day,
          isLeap: false,
          yearGanZhi: lunarResult.gzYear,
          monthGanZhi: lunarResult.gzMonth,
          dayGanZhi: lunarResult.gzDay,
          lunarMonthName: lunarResult.IMonthCn,
          lunarDayName: lunarResult.IDayCn,
          term: lunarResult.Term || ''
        };
      }

      // 解析时辰 - 简化版本
      const timeHour = parseInt(time.split(':')[0]);
      const shichen = this.getShichen(timeHour);

      // 执行小六壬推算
      const xiaoLiuRenResult = this.calculateXiaoLiuRen(lunarDate.month, lunarDate.day, timeHour);

      // 构建分析结果
      const calendarTypeText = calendar_type === "lunar" ? "农历" : "阳历";

      return `小六壬占卜结果：

🗓️ 输入信息：
- 原始日期：${date}（${calendarTypeText}）
- 时辰：${time} (${shichen})

📅 农历信息：
- 农历日期：${lunarDate.year}年${lunarDate.lunarMonthName}${lunarDate.lunarDayName}${lunarDate.isLeap ? '(闰月)' : ''}
- 年干支：${lunarDate.yearGanZhi}
- 月干支：${lunarDate.monthGanZhi} 
- 日干支：${lunarDate.dayGanZhi}
- 时辰：${shichen}
${lunarDate.term ? `- 节气：${lunarDate.term}` : ''}

🧮 小六壬推算过程：
- ${xiaoLiuRenResult.calculation.月将}
- ${xiaoLiuRenResult.calculation.日期}  
- ${xiaoLiuRenResult.calculation.时辰}

🔮 占卜结果：【${xiaoLiuRenResult.finalResult.name}】
- 五行属性：${xiaoLiuRenResult.finalResult.element}
- 吉凶性质：${xiaoLiuRenResult.finalResult.nature}
- 基本含义：${xiaoLiuRenResult.finalResult.meaning}
- 详细解释：${xiaoLiuRenResult.finalResult.details}

💡 建议指导：
${this.getAdvice(xiaoLiuRenResult.finalResult.name)}`;

    } catch (error) {
      throw new Error(`日期时间处理错误：${error.message}`);
    }
  }

index.js:35-54 (schema)

Input schema for the analyze_xiaoliuren tool, defining parameters for date, time, and calendar_type with validation.

inputSchema: {
  type: "object",
  properties: {
    date: {
      type: "string",
      description: "日期，格式：YYYY-MM-DD",
    },
    time: {
      type: "string",
      description: "时辰，格式：HH:MM 或者传统时辰名称（如：子时、丑时等）",
    },
    calendar_type: {
      type: "string",
      enum: ["solar", "lunar"],
      description: "日历类型：solar=阳历，lunar=农历",
      default: "solar"
    }
  },
  required: ["date", "time", "calendar_type"],
},

index.js:32-55 (registration)

Tool registration in the ListTools response, including name, description, and input schema.

{
  name: "analyze_xiaoliuren",
  description: "分析指定日期时辰的小六壬指导意见",
  inputSchema: {
    type: "object",
    properties: {
      date: {
        type: "string",
        description: "日期，格式：YYYY-MM-DD",
      },
      time: {
        type: "string",
        description: "时辰，格式：HH:MM 或者传统时辰名称（如：子时、丑时等）",
      },
      calendar_type: {
        type: "string",
        enum: ["solar", "lunar"],
        description: "日历类型：solar=阳历，lunar=农历",
        default: "solar"
      }
    },
    required: ["date", "time", "calendar_type"],
  },
},

index.js:60-88 (handler)

MCP CallTool request handler that dispatches to analyzeXiaoLiuRen when the tool name matches 'analyze_xiaoliuren', handles errors, and formats the response.

this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
  if (request.params.name === "analyze_xiaoliuren") {
    const { date, time, calendar_type } = request.params.arguments;

    try {
      const result = await this.analyzeXiaoLiuRen(date, time, calendar_type);
      return {
        content: [
          {
            type: "text",
            text: result,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `错误：${error.message}`,
          },
        ],
        isError: true,
      };
    }
  }

  throw new Error(`未知工具: ${request.params.name}`);
});

index.js:252-322 (helper)

Core computation helper for Xiao Liu Ren algorithm: defines the six gods with detailed meanings, computes positions based on lunar month, day, and shichen index using modular arithmetic.

calculateXiaoLiuRen(lunarMonth, lunarDay, hour) {
  // 六神定义 - 更详细的传统解释
  const sixGods = [
    {
      name: '大安',
      element: '木',
      nature: '吉',
      meaning: '安稳安逸美事，但也有静止之意。事情平稳发展，宜守不宜动。',
      details: '大安为吉宫，主平稳、安定。感情方面发展平稳但可能过于平淡，财运稳定有进有出。适合问"能否成功"类问题，不适合问"能否行动"类问题。'
    },
    {
      name: '留连',
      element: '土',
      nature: '凶',
      meaning: '反复、犹豫、拖延、漫长、纠缠、暧昧。纯阴卦，主不光明、秘密、隐私。',
      details: '留连纯阴卦，代表事情未定，仍有变化。夜晚测得尤为不稳定。与小吉同处吉凶交界，但凶性稍多。事情发展缓慢，多有阻碍。'
    },
    {
      name: '速喜',
      element: '火',
      nature: '吉',
      meaning: '火热、快速、好事。有好事但不长久，应快速行动把握时机。',
      details: '速喜为吉宫，如大火燎原，一烧既尽。短期事情大吉（考试、消息、决策），长期事情后劲不足。为朱雀，有口舌争辩之象。'
    },
    {
      name: '赤口',
      element: '金',
      nature: '凶',
      meaning: '口舌官非、吵闹打斗、意外凶险。为白虎，代表挫败和突发意外。',
      details: '赤口为凶宫，主口舌官非。落此宫事情已非常凶，必定失败且为挫败。也主精神紧张，对所问之事不抱希望。但也有交谈、合作等正面象意。'
    },
    {
      name: '小吉',
      element: '水',
      nature: '平',
      meaning: '驿马宫，为动，向好发展但力量微弱需自身努力。为桃花，主美事。',
      details: '小吉为纯阳卦，变化可能性最大。成功与否更多取决于个人努力和行动。消极对待则吉性减退，积极行动则成功率增加。'
    },
    {
      name: '空亡',
      element: '土',
      nature: '凶',
      meaning: '空、亡，事情落空不成，但也有无事之意。性质特殊，倾向虚无。',
      details: '空亡有两种可能：一是大凶结果很差，二是什么都不会发生。问失物为未丢，问寻找为找不到。常代表弃考、放弃等情况。'
    }
  ];

  // 第一步：月将推算（从大安开始，按农历月份数）
  let monthPosition = (lunarMonth - 1) % 6;

  // 第二步：日期推算（从月将位置开始，按农历日期数）
  let dayPosition = (monthPosition + lunarDay - 1) % 6;

  // 第三步：时辰推算（从日期位置开始，按时辰序号数）
  let shichenIndex = this.getShichenIndex(hour);
  let finalPosition = (dayPosition + shichenIndex - 1) % 6;

  // 获取最终结果
  const result = sixGods[finalPosition];

  return {
    monthPosition: sixGods[monthPosition].name,
    dayPosition: sixGods[dayPosition].name,
    finalResult: result,
    calculation: {
      月将: `农历${lunarMonth}月 → ${sixGods[monthPosition].name}`,
      日期: `从${sixGods[monthPosition].name}数${lunarDay}日 → ${sixGods[dayPosition].name}`,
      时辰: `从${sixGods[dayPosition].name}数${shichenIndex}(时辰序号) → ${result.name}`
    }
  };
}

XiaoLiuRen MCP Server