Yijing Bazi MCP Server

Instructions

Implementation Reference

• src/engines/bazi-engine.js:30-107 (handler)

  The primary handler function that executes the core logic for generating a Bazi (Four Pillars) chart from birth details. It handles time conversion, lunar/solar calendar, computes four pillars, major/minor luck cycles, gods/spirits, five elements, and ten gods analysis.

  async generateChart({ birth_datetime, timezone, gender, location, use_true_solar_time = false, is_lunar = false }) {
    try {
      this.logger.info('开始生成八字排盘', { birth_datetime, timezone, gender });
  
      // 转换时间
      const birthMoment = moment.tz(birth_datetime, timezone);
  
      // 真太阳时校正
      let adjustedTime = birthMoment;
      if (use_true_solar_time && location) {
        adjustedTime = this.calculator.adjustForTrueSolarTime(birthMoment, location);
      }
  
      // 根据is_lunar参数处理农历/公历日期
      let lunar, solar;
      if (is_lunar) {
        // 如果输入的是农历日期，需要先创建农历对象再转换为公历
        const year = adjustedTime.year();
        const month = adjustedTime.month() + 1; // moment月份从0开始
        const day = adjustedTime.date();
        const hour = adjustedTime.hour();
        const minute = adjustedTime.minute();
  
        lunar = Lunar.fromYmdHms(year, month, day, hour, minute, 0);
        solar = lunar.getSolar();
        // 更新adjustedTime为转换后的公历时间
        adjustedTime = moment.tz(`${solar.getYear()}-${solar.getMonth()}-${solar.getDay()} ${hour}:${minute}:00`, timezone);
      } else {
        // 如果输入的是公历日期，直接从公历创建农历对象
        lunar = Lunar.fromDate(adjustedTime.toDate());
        solar = lunar.getSolar();
      }
  
      // 计算四柱八字
      const fourPillars = this.calculateFourPillars(lunar, adjustedTime);
  
      // 计算大运
      const majorLuck = this.calculateMajorLuck(fourPillars, gender, lunar);
  
      // 计算流年
      const annualLuck = this.calculateAnnualLuck(adjustedTime.year());
  
      // 计算神煞
      const spirits = this.calculateSpirits(fourPillars);
  
      // 五行分析
      const fiveElementsAnalysis = this.analyzeFiveElements(fourPillars);
  
      // 十神分析
      const tenGodsAnalysis = this.analyzeTenGods(fourPillars);
  
      const result = {
        timestamp: new Date().toISOString(),
        birth_info: {
          solar_datetime: solar.toYmdHms(),
          lunar_date: lunar.toFullString(),
          timezone: timezone,
          gender: gender,
          location: location,
          use_true_solar_time: use_true_solar_time
        },
        four_pillars: fourPillars,
        major_luck: majorLuck,
        annual_luck: annualLuck,
        spirits_and_stars: spirits,
        five_elements: fiveElementsAnalysis,
        ten_gods: tenGodsAnalysis,
        chart_quality: this.evaluateChartQuality(fourPillars, fiveElementsAnalysis),
        basic_personality: this.analyzeBasicPersonality(fourPillars, fiveElementsAnalysis)
      };
  
      this.logger.info('八字排盘生成成功');
      return result;
    } catch (error) {
      this.logger.error('八字排盘生成失败', { error: error.message });
      throw error;
    }
  }

• src/index.js:415-426 (registration)

  Registration and dispatch logic in the CallToolRequestSchema handler. Maps incoming tool arguments to the BaziEngine.generateChart method after parameter adaptation.

  case 'bazi_generate_chart':
    // 转换参数格式以匹配BaziEngine期望的格式
    const chartArgs = {
      birth_datetime: args.birth_time,
      timezone: args.birth_location?.timezone || 'Asia/Shanghai',
      gender: args.gender,
      location: args.birth_location,
      use_true_solar_time: false,
      is_lunar: args.is_lunar || false
    };
    result = await baziEngine.generateChart(chartArgs);
    break;

• src/utils/validator.js:142-156 (schema)

  Joi-based input schema validation specifically for the bazi_generate_chart tool parameters, used in runtime validation.

  function createBaziGenerateChartSchema() {
    return Joi.object({
      birth_time: Joi.alternatives().try(
        Joi.date().iso(),
        Joi.string().pattern(/^\d{4}-\d{2}-\d{2}(\s\d{2}:\d{2}(:\d{2})?)?$/)
      ).required(),
      is_lunar: Joi.boolean().default(false),
      gender: Joi.string().valid('male', 'female', '男', '女').required(),
      birth_location: Joi.object({
        latitude: Joi.number().min(-90).max(90).optional(),
        longitude: Joi.number().min(-180).max(180).optional(),
        timezone: Joi.string().default('Asia/Shanghai')
      }).optional()
    });
  }

• src/index.js:162-192 (schema)

  Static input schema definition for bazi_generate_chart returned by the ListToolsRequestSchema handler.

    name: 'bazi_generate_chart',
    description: '生成八字命盘',
    inputSchema: {
      type: 'object',
      properties: {
        birth_time: {
          type: 'string',
          format: 'date-time',
          description: '出生时间（阳历）'
        },
        is_lunar: {
          type: 'boolean',
          description: '是否为农历日期'
        },
        gender: {
          type: 'string',
          enum: ['male', 'female'],
          description: '性别'
        },
        birth_location: {
          type: 'object',
          properties: {
            longitude: { type: 'number' },
            latitude: { type: 'number' }
          },
          description: '出生地经纬度（可选，用于精确计算）'
        }
      },
      required: ['birth_time', 'gender']
    }
  },