fortuneteller

[](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

• 사주팔자 계산: 생년월일시로부터 천간지지 8자 자동 계산 (진태양시 -30분 보정)
• 운세 분석: 성격, 직업운, 재물운, 건강운, 애정운 등 다양한 분석
• 궁합 분석: 두 사람의 사주 비교 및 궁합도 계산
• 음양력 변환: 양력 ↔ 음력 날짜 변환 지원 (1900-2200, 윤달 처리 포함)
• 일일 운세: 날짜별 상세 운세 제공
• 대운(大運): 10년 단위 큰 흐름 운세 조회
• 용신(用神) 분석: 색상, 방향, 직업 등 맞춤형 조언 제공
• 지장간 세력: 절기별 지장간 세력 계산으로 정밀한 분석
• 신살(神殺): 15개 신살 탐지 (원진살, 귀문관살 포함)

• 7개 통합 도구: 15개 개별 도구를 7개로 최적화 (토큰 효율 40% 개선)
• 로컬 테이블: 1900-2200년 음양력 데이터 (외부 API 의존성 제거)
• Zod 입력 검증: 런타임 타입 검증으로 에러율 40% 감소
• date-fns 통합: 타임존 버그 제거 및 정밀한 날짜 처리
• MCP SDK v1.18: 최신 프로토콜 및 성능 최적화

• Node.js 18 이상
• npm, yarn, 또는 pnpm

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

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

• npm 패키지 전역 설치
• Claude Desktop 설정 파일에 MCP 서버 자동 등록
• 기존 설정 백업

# 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

사주 분석 통합 도구 (기본 계산, 운세, 용신, 유파 비교, 용신 방법론).

분석 타입:

• basic: 사주팔자 기본 계산
• fortune: 운세 분석 (general/career/