Saju Fortune-Telling MCP Server

Instructions

Implementation Reference

• src/tools/check_compatibility.ts:22-46 (handler)

  Main handler function for the 'check_compatibility' tool. Calculates saju data for two persons using calculateSaju and performs compatibility analysis using checkCompatibility, returning JSON result.

  export function handleCheckCompatibility(args: CheckCompatibilityArgs): string {
    const { person1, person2 } = args;
  
    // 각 사람의 사주 계산
    const sajuData1 = calculateSaju(
      person1.birthDate,
      person1.birthTime,
      person1.calendar || 'solar',
      person1.isLeapMonth || false,
      person1.gender
    );
  
    const sajuData2 = calculateSaju(
      person2.birthDate,
      person2.birthTime,
      person2.calendar || 'solar',
      person2.isLeapMonth || false,
      person2.gender
    );
  
    // 궁합 분석
    const compatibility = checkCompatibility(sajuData1, sajuData2);
  
    return JSON.stringify(compatibility);
  }

• src/schemas/index.ts:63-78 (schema)

  Zod schema for validating input to check_compatibility tool, defining structure for person1 and person2 data.

  export const CheckCompatibilitySchema = z.object({
    person1: z.object({
      birthDate: DateSchema.describe('생년월일 (YYYY-MM-DD)'),
      birthTime: TimeSchema.describe('출생 시간 (HH:mm)'),
      calendar: CalendarTypeSchema.default('solar').describe('달력 타입'),
      isLeapMonth: z.boolean().default(false).describe('음력 윤달 여부'),
      gender: GenderSchema.describe('성별')
    }).describe('첫 번째 사람'),
    person2: z.object({
      birthDate: DateSchema.describe('생년월일 (YYYY-MM-DD)'),
      birthTime: TimeSchema.describe('출생 시간 (HH:mm)'),
      calendar: CalendarTypeSchema.default('solar').describe('달력 타입'),
      isLeapMonth: z.boolean().default(false).describe('음력 윤달 여부'),
      gender: GenderSchema.describe('성별')
    }).describe('두 번째 사람')
  });

• src/core/tool-definitions.ts:49-80 (registration)

  Lazy registration of the 'check_compatibility' tool schema in the toolSchemaFactories object.

  check_compatibility: () => ({
    name: 'check_compatibility',
    description: '두 사람 궁합 분석',
    inputSchema: {
      type: 'object',
      properties: {
        person1: {
          type: 'object',
          properties: {
            birthDate: { type: 'string' },
            birthTime: { type: 'string' },
            calendar: { type: 'string', enum: ['solar', 'lunar'], default: 'solar' },
            isLeapMonth: { type: 'boolean', default: false },
            gender: { type: 'string', enum: ['male', 'female'] },
          },
          required: ['birthDate', 'birthTime', 'gender'],
        },
        person2: {
          type: 'object',
          properties: {
            birthDate: { type: 'string' },
            birthTime: { type: 'string' },
            calendar: { type: 'string', enum: ['solar', 'lunar'], default: 'solar' },
            isLeapMonth: { type: 'boolean', default: false },
            gender: { type: 'string', enum: ['male', 'female'] },
          },
          required: ['birthDate', 'birthTime', 'gender'],
        },
      },
      required: ['person1', 'person2'],
    },
  }),

• src/core/tool-handler.ts:29-30 (registration)

  Dispatch in the main tool handler switch statement that routes 'check_compatibility' calls to handleCheckCompatibility.

  case 'check_compatibility':
    return handleCheckCompatibility(args as Parameters<typeof handleCheckCompatibility>[0]);

• src/lib/compatibility.ts:12-81 (helper)

  Core compatibility analysis function that performs detailed analysis including day pillar, element harmony, branch relations, and ten gods compatibility to compute overall score and advice.

  export function checkCompatibility(person1: SajuData, person2: SajuData): CompatibilityAnalysis {
    // 1. 일주 궁합 (가장 중요)
    const dayCompatibility = analyzeDayPillarCompatibility(person1, person2);
  
    // 2. 오행 조화
    const elementHarmony = analyzeElementHarmony(person1, person2);
  
    // 3. 지지 충극 관계
    const branchRelation = analyzeBranchRelation(person1, person2);
  
    // 4. 십성 궁합
    const tenGodsCompatibility = analyzeTenGodsCompatibility(person1, person2);
  
    // 종합 점수 계산
    const compatibilityScore = calculateOverallScore(
      dayCompatibility,
      elementHarmony,
      branchRelation,
      tenGodsCompatibility
    );
  
    // 장단점 분석
    const strengths: string[] = [];
    const weaknesses: string[] = [];
    const advice: string[] = [];
  
    if (dayCompatibility.score >= 70) {
      strengths.push('일주 궁합이 좋아 기본적으로 잘 맞는 사이입니다');
    } else if (dayCompatibility.score < 50) {
      weaknesses.push('일주가 충돌하여 의견 차이가 있을 수 있습니다');
      advice.push('서로의 차이를 인정하고 존중하는 자세가 필요합니다');
    }
  
    if (elementHarmony.harmony >= 70) {
      strengths.push('오행이 조화로워 서로를 보완합니다');
    } else if (elementHarmony.harmony < 50) {
      weaknesses.push('오행이 충돌하여 갈등이 생길 수 있습니다');
      advice.push('상대방의 장점을 인정하고 이해하려 노력하세요');
    }
  
    if (branchRelation.isHarmony) {
      strengths.push('지지가 조화로워 편안한 관계를 유지합니다');
    } else if (branchRelation.isConflict) {
      weaknesses.push('지지가 충돌하여 예기치 않은 문제가 발생할 수 있습니다');
      advice.push('감정적인 대립을 피하고 이성적으로 대화하세요');
    }
  
    // 십성 궁합
    if (tenGodsCompatibility.score >= 70) {
      strengths.push(tenGodsCompatibility.description);
    } else if (tenGodsCompatibility.score < 50) {
      weaknesses.push(tenGodsCompatibility.description);
      advice.push(tenGodsCompatibility.advice);
    }
  
    // 성격 궁합
    const personalityMatch = analyzePersonalityMatch(person1, person2);
    strengths.push(...personalityMatch.strengths);
    weaknesses.push(...personalityMatch.weaknesses);
    advice.push(...personalityMatch.advice);
  
    return {
      compatibilityScore,
      summary: getSummary(compatibilityScore),
      strengths,
      weaknesses,
      advice,
      elementHarmony,
    };
  }