Ziwei

생년월일·출생시각·성별을 받아 자미두수(紫微斗数) 명반을 계산해 반환하는 MCP 서버. 12궁 + 주성/보좌성 + 사화(四化) 텍스트와 12궁 명반 PNG를 돌려준다.

구조·네이밍·PNG·설치 규약은 STANDARD.md를 따른다. mcp-qr skeleton 복제본.

---

계산 / 렌더

• 계산: iztro — 경량 자미두수 성반 생성 라이브러리(JS). 한국어 로케일 ko-KR 지원.
• 렌더: @napi-rs/canvas(prebuilt) — 12궁 4×4 그리드 직접 렌더.
• 결정론적: 같은 입력 → 같은 명반.

---

도구

get_ziwei

파라미터	타입	필수	기본	설명
birthDate	string YYYY-MM-DD	✅	—	생년월일
birthTime	string HH:MM	✅	—	출생시각 → 時辰 인덱스로 변환
gender	male | female	✅	—	성별
calendarType	solar | lunar		solar	양/음력
lang	string		ko-KR	로케일

時辰 변환 (HH:MM → timeIndex 012): iztro util.timeToIndex 사용. 子시는 早子(00:0000:59 → 0)·晚子(23:00~23:59 → 12)로 분리한다.

출력 (둘 다 반환):

1. 구조화 텍스트 — 12궁(천간지지·주성·보좌성·명궁★/신궁☆) + 명주/신주/오행국 + 사화(록/권/과/기)
2. 명반 PNG (1080×1080, 12궁 4×4 그리드, 중앙 출생정보)

예제 출력: examples/ziwei_example.png (양력 2000-08-16 03:00 寅시 · 여성).

---

설치

git clone https://github.com/molpass/mcp-ziwei.git
cd mcp-ziwei
npm install && npm run build

예제 명반을 직접 생성해 보려면:

npm run example   # examples/ziwei_example.png 재생성

폰트: 한글·한자 라벨을 위해 한글 가능 폰트가 필요하다. Windows는 Malgun Gothic 기본 탑재라 추가 설치 불필요. Linux는 Nanum/Noto CJK 권장.

---

MCP 등록 (서버명 ziwei)

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

/abs/path는 클론한 실제 절대경로로 바꾼다. Windows 예: "args": ["C:/Users/<you>/mcp-ziwei/dist/index.js"]

---

스킬

페어링 스킬: skill/ziwei.skill.md.

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

License

MIT