Skip to main content
Glama
molpass

sajuMCP

by molpass
OverviewSchemaSourceRelated ServersScoreDiscussionsAdmin
JavaScript
Local

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 서버입니다.

같은 모음: