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를 잠시 내려받음).

Related MCP server: BaZi (Eight Characters) Calculator

MCP 클라이언트 등록

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

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

도구: calculate_saju

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

입력

출력

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 — 한국 주요뉴스