Saju Insights provides personalized Korean traditional Four Pillars of Destiny (Saju) fortune-telling based on birth data. It calculates destiny charts using the eight characters (four heavenly stems and four earthly branches) derived from birth year, month, day, and hour. Key capabilities include: - Birth chart calculation with automatic True Solar Time adjustment (Jintaeyangsi -30min correction) - Fortune analysis covering personality, career, wealth, health, and love prospects - Relationship compatibility analysis comparing two people's Saju charts - 10-year luck cycle (Daewon) predictions for long-term planning - Yongsin (favorable element) guidance on lucky colors, directions, and career paths - Lunar-solar calendar conversion supporting 1900-2200 with leap month handling - Daily fortune readings and seasonal power calculations - Multiple interpretation schools including Ziping, DTS, and modern methodologies

🔮 사주 운세 MCP 서버 (Saju MCP Server)

[](https://www.npmjs.com/package/@hoshin/saju-mcp-server) [](https://opensource.org/licenses/MIT) [](https://nodejs.org)

한국 전통 사주팔자를 기반으로 운세를 분석하는 MCP(Model Context Protocol) 서버입니다.

A Model Context Protocol (MCP) server for Korean traditional Saju (Four Pillars of Destiny) fortune-telling.

> 🌏 Language: 한국어 | English

✨ 주요 기능

🆕 v1.1.0 신규 기능

🚀 시작하기

필수 요구사항

설치

#### 자동 설치 스크립트 (가장 간편)

# 설치 스크립트 다운로드 및 실행
curl -fsSL https://raw.githubusercontent.com/hjsh200219/fortuneteller/main/install.sh | bash

이 스크립트는 다음을 자동으로 수행합니다:

#### 수동 설치

# npm으로 전역 설치
npm install -g @hoshin/saju-mcp-server
또는 npx로 직접 실행
npx @hoshin/saju-mcp-server

#### 소스에서 빌드

# 저장소 클론
git clone https://github.com/hjsh200219/fortuneteller.git
cd fortuneteller
의존성 설치
npm install
개발 모드 실행
npm run dev
프로덕션 빌드
npm run build
npm start

🛠️ MCP 도구 (총 7개 - 통합 최적화)

1. analyze_saju

분석 타입:

{
  birthDate: "1990-03-15",
  birthTime: "10:30",
  calendar: "solar",
  isLeapMonth: false,
  gender: "male",
  analysisType: "basic" | "fortune" | "yongsin" | "school_compare" | "yongsin_method",
  // fortune 타입용 옵션
  fortuneType?: "general" | "career" | "wealth" | "health" | "love",
  // school_compare 타입용 옵션
  schools?: ["ziping", "dts", "qtbj", "modern", "shensha"],
  // yongsin_method 타입용 옵션
  method?: "strength" | "seasonal" | "mediation" | "disease"
}

2. check_compatibility

{
  person1: {
    birthDate: "1990-03-15",
    birthTime: "10:30",
    calendar: "solar",
    isLeapMonth: false,
    gender: "male"
  },
  person2: {
    birthDate: "1992-07-20",
    birthTime: "14:30",
    calendar: "solar",
    isLeapMonth: false,
    gender: "female"
  }
}

3. convert_calendar

{
  date: "2025-01-01",
  fromCalendar: "solar",
  toCalendar: "lunar",
  isLeapMonth?: false
}

4. get_daily_fortune

{
  birthDate: "1990-03-15",
  birthTime: "10:30",
  calendar: "solar",
  isLeapMonth: false,
  gender: "male",
  targetDate: "2025-01-01"
}

5. get_dae_un

{
  birthDate: "1990-03-15",
  birthTime: "10:30",
  calendar: "solar",
  isLeapMonth: false,
  gender: "male"
}

6. get_fortune_by_period

기간 타입:

{
  birthDate: "1990-03-15",
  birthTime: "10:30",
  calendar: "solar",
  isLeapMonth: false,
  gender: "male",
  periodType: "year" | "month" | "hour" | "multi-year",
  // 기간 지정 (periodType에 맞는 형식)
  target?: "2025" | "2025-03" | "2025-01-01 14:00",
  // multi-year 타입용 옵션
  count?: 5  // 조회할 연도 개수 (기본값: 5)
}

7. manage_settings

액션:

{
  action: "get" | "set",
  // set 액션용 옵션
  preset?: "ziping" | "dts" | "qtbj" | "modern" | "shensha" | "balanced",
  // 또는 커스텀 가중치
  custom?: {
    ziping: 0.3,    // 자평명리 가중치 (0.0-1.0)
    dts: 0.2,       // 적천수 가중치
    qtbj: 0.2,      // 궁통보감 가중치
    modern: 0.2,    // 현대명리 가중치
    shensha: 0.1    // 신살중심 가중치
  }
}

📁 프로젝트 구조

``` fortuneteller/ ├── src/ │ ├── index.ts # MCP 서버 진입점 │ ├── core/ # 핵심 시스템 │ │ ├── tool-definitions.ts # 7개 도구 정의 │ │ └── tool-handler.ts # 도구 라우팅 │ ├── tools/ # MCP 도구 구현 │ │ ├── analyze_saju.ts # 통합 사주 분석 │ │ ├── check_compatibility.ts │ │ ├── convert_calendar.ts │ │ ├── get_daily_fortune.ts │ │ ├── get_dae_un.ts │ │ ├── get_fortune_by_period.ts # 통합 시간대별 운세 │ │ └── manage_settings.ts # 통합 설정 관리 │