mcp-saju

ssaju 만세력 엔진을 래핑한 stdio MCP 서버. MCP 클라이언트(Claude Desktop·Claude Code 등)가 생년월일시로 사주·만세력을 계산하도록 calculate_saju 도구를 노출한다.

• 엔진: ssaju (MIT · TypeScript · 의존성 0 · 원국·십성·12운성·합충형파해·신살·격국·용신·대운·세운·월운·공망 한 번에 산출)
• 트랜스포트: stdio (클라이언트가 서브프로세스로 실행)
• 라이선스: MIT

설치 / 빌드

npm install
npm run build      # tsc → dist/index.js

git 필요: 엔진 의존성 ssaju를 molpass/ssaju 포크에서 git으로 가져온다(serializeSaju 포함, 커밋 핀 고정). 따라서 npm install 시 git이 설치돼 있어야 하며, 설치 과정에서 포크를 clone해 자동 빌드한다(빌드 devDependencies를 잠시 내려받음).

MCP 클라이언트 등록

클라이언트의 MCP 서버 설정에 stdio 명령으로 추가한다.

{
  "mcpServers": {
    "saju": {
      "command": "node",
      "args": ["/abs/path/mcp-saju/dist/index.js"]
    }
  }
}

도구: calculate_saju

생년월일시로 사주·만세력을 계산한다.

입력

파라미터	타입	기본값	설명
year	number	(필수)	연도
month	number	(필수)	월 1–12
day	number	(필수)	일 1–31
hour	number	12	시 0–23
minute	number	0	분 0–59
gender	"남" | "여"	(없음)	대운 방향에 영향 → 정확한 결과 위해 제공 권장
calendar	"solar" | "lunar"	"solar"	입력 달력 종류
leap	boolean	false	음력 윤달 여부
timezone	string	"Asia/Seoul"	IANA 시간대
longitude	number	(없음)	진태양시 보정용 경도
applyLocalMeanTime	boolean	(없음)	진태양시 보정 적용
format	"compact" | "markdown" | "json"	"compact"	출력 형식 (compact=LLM용 압축, markdown=사람용 상세, json=구조화 데이터)

출력

format에 따라 ssaju의 toCompact()(기본, ~950토큰) 또는 toMarkdown()(~2,170토큰) 문자열을, json이면 serializeSaju()로 직렬화한 구조화 JSON(함수 필드 제외)을 텍스트로 반환한다.

예시

입력:

{ "year": 2001, "month": 11, "day": 3, "hour": 14, "minute": 20, "gender": "남" }

출력(첫 줄):

일간 庚(경)금+  강약: 강(78)  격: 인수격  용신: 己, 丙, 癸

검증

npm test

test/smoke.test.js — 빌드된 서버에 stdio JSON-RPC 1왕복(initialize → tools/call)을 보내 위 예시 입력의 결과에 일간 庚 · 인수격 · 용신 己·丙·癸가 그대로 나오는지 확인하는 회귀 테스트.

MCP Inspector로 수동 검증:

npx @modelcontextprotocol/inspector node dist/index.js

GUI에서 calculate_saju를 위 예시 입력으로 호출하면 동일 결과를 확인할 수 있다.

About / 제작

Hermes Agent용 MCP — molpass의 바이브 코딩(vibe coding) 프로젝트.

• 아이디어·방향: molpass (이정훈) · https://zeolinex.com
• 기획: Claude (Chat)
• 개발: Claude Code

자가 호스팅 Hermes Agent에 도구로 붙여 쓰는 MCP 서버입니다.

같은 모음:

• mcp-saju — 사주명리 만세력
• mcp-qr — QR 코드 생성
• mcp-biorhythm — 바이오리듬
• mcp-astrology — 서양 점성술 네이탈 차트
• mcp-ziwei — 자미두수 명반
• mcp-numerology — 수비학
• mcp-liuren — 대육임
• mcp-qimen — 기문둔갑
• mcp-taiyi — 태을신수
• mcp-weather — 한국 날씨·미세먼지
• mcp-newsfeed — 한국 주요뉴스