true-solar-time-mcp

사주(四柱) 명리 차트를 위한 진태양시 보정 — 대부분의 계산기가 건너뛰는 단계.

기록된 출생 시각(벽시계 + IANA 시간대 + 경도)을 출생지의 실제 태양 시각으로 변환하는 MCP 서버, CLI, TypeScript 라이브러리입니다. 결정적(deterministic)입니다: 동일한 입력은 언제나 동일한 출력을 냅니다.

$ npx true-solar-time 1988-07-01 08:00 Asia/Shanghai 121.47

clock time    1988-07-01 08:00 (Asia/Shanghai, DST GMT+9)
true solar    1988-07-01 07:02
correction    -58 min
  DST         -60
  longitude   +6
  eq. of time -4
hour branch   辰 (2 min from 卯)
⚠ within 8 min of a branch boundary — cast both candidates

왜 필요한가

사주 차트는 태양의 위치에 대한 함수이지만, 출생 기록은 민간 시계 시간으로 작성됩니다. 그 사이에는 거의 모든 차트 도구 — 인기 있는 오픈소스 LLM "스킬"까지 포함하여 — 가 조용히 건너뛰는 세 가지 보정이 있습니다:

1. 역사적 일광절약시간(DST). 중국은 1986년부터 1991년까지 일광절약시간제를 시행했습니다. 그 여섯 해의 여름에 태어난 모든 사람의 출생 증명서에는 시계가 한 시간 앞으로 당겨진 시간이 기록되어 있습니다 — 이는 시간 기둥(時柱) 전체를 넘어설 만큼의 차이이며, 밤의 적절한 시각에는 일 기둥(日柱)까지 바꿀 수 있습니다. IANA/ICU 시간대 데이터베이스는 이를 알고 있습니다. 대부분의 계산기는 그걸 묻지 않을 뿐입니다.

2. 경도. 중국은 네 개의 지리적 시간대에 걸쳐 있으며 하나의 시계를 사용합니다. 우루무치에서 베이징 시간 07:10은 현지 태양시로 겨우 05:00을 조금 넘긴 시각입니다 — 두 기둥 전체가 차이납니다.

3. 균시차(Equation of time). 진태양시와 평균태양시는 연중 최대 ±16분까지 차이가 벌어집니다 (여기서는 NOAA 근사식을 사용하며, 오차는 1분 미만입니다). 11월 초에는 이 차이만으로도 차트가 기둥 경계를 넘을 수 있습니다.

이 라이브러리는 또한 대부분의 도구가 알려주지 않는 두 가지를 보고합니다:

• 출생 시각이 실제로 존재했는지 여부. 봄에 시계를 앞당기는 날 밤, 현지 시계는 01:59에서 03:00으로 점프합니다. 02:30으로 기록된 출생 기록은 실제 순간을 가리키지 않습니다. 우리는 그 공백을 감지하고, 그 폭을 보고하며, 조용히 추측하지 않습니다.

• 보정된 시각이 기둥 경계에 얼마나 가까운지. 몇 분 이내라면, 정직한 답은 "두 후보 모두 작성하라"는 것이지, 거짓된 정밀도가 아닙니다.

Related MCP server: BaZi (Eight Characters) Calculator

의도적으로 하지 않는 일

차트를 작성하지 않으며, 유리한 오행을 고르지 않으며, 어떤 해석도 하지 않습니다. 차트 작성은 훌륭한 오픈소스 구현이 이미 있는 해결된 문제이고, 해석은 유일한 정답이 없으므로 조회 라이브러리에 들어갈 일이 아닙니다. 한 단계를, 신중하게 처리합니다.

전체 방법론 — 모든 상수, 임계값, 관례(이 라이브러리가 사용하는 것 포함) — 은 auspiceoracle.com/en/method 에 공개되어 있습니다. 전체 유도 과정이 포함된 세 가지 실제 예제: 출생 시각 테스트. 배경 에세이: 진태양시.

MCP 서버

호스팅 엔드포인트 (설치 불필요): https://auspiceoracle.com/mcp — 무상태(stateless) 스트리밍 HTTP, 인증 불필요. claude.ai 사용자 지정 커넥터 또는 스트리밍 HTTP를 지원하는 모든 MCP 클라이언트에서 작동합니다:

{
  "mcpServers": {
    "true-solar-time": { "url": "https://auspiceoracle.com/mcp" }
  }
}

로컬 (stdio):

{
  "mcpServers": {
    "true-solar-time": {
      "command": "npx",
      "args": ["-y", "true-solar-time-mcp"]
    }
  }
}

도구:

• true_solar_time — 전체 보정: 보정된 시각, DST/경도/균시차 항목별 분석(세 항목은 항상 정확히 합계와 일치), 시간 기둥, 경계 거리, 비존재 시각 감지.

• hour_branch — 이미 보정된 시각에 대한 기둥 소속 및 경계 거리.

호스팅 엔드포인트는 추가로 cast_pillars를 노출합니다 — 태양시 보정된 사주 네 기둥(천간·지지 포함), 납음, 대운을 프로덕션 Auspice Oracle 엔진(비공개 소스, 공개된 방법론과 동일한 관례)으로 계산합니다. 사실만 제공합니다 — 강약 판단도, 해석도 없습니다.

BaZi 스킬이나 에이전트를 구축 중이라면: 차트 작성 전에 true_solar_time을 호출하고, 보정된 시각을 차트 작성기에 전달하세요. LLM은 이 변환을 컨텍스트 내에서 수행할 수 없습니다 — 균시차는 삼각함수 급수이고 DST 역사는 모델 가중치가 아닌 데이터베이스에 있기 때문입니다.

라이브러리

import { toTrueSolarTime } from 'true-solar-time-mcp'

const r = toTrueSolarTime(1992, 6, 15, 7, 10, 'Asia/Shanghai', 87.6)
// r.hour === 4, r.minute === 59, r.correctionMinutes === -130
// r.hourBranch === '寅' — two branches away from what the clock says

관례, 명확히 밝힘

• 시간 기둥은 홀수 시각에 바뀝니다 (子는 23:00에 시작), 각 120분.

• 경계 위험 플래그는 8분 임계값을 사용합니다. 이는 물리 법칙이 아닌 관례입니다 — 자신의 허용 오차에 맞게 조정하세요. 경계 부근의 차트는 어느 쪽이든 양쪽 모두 작성해야 합니다.

• 역사적 시간대는 런타임의 ICU 데이터(Node ≥ 18)에서 가져옵니다. 자체 테이블을 유지하지 않습니다.

• 표준 오프셋 자체가 연중 변경된 경우(러시아 2011), 항목별 분석의 DST/경도 구분이 완벽하지 않을 수 있습니다. 총 보정량은 항상 실제 오프셋에서 계산되며 영향을 받지 않습니다.

auspiceoracle.com과의 관계

이것은 Auspice Oracle 뒤에 있는 엔진의 태양시 계층을 추출한 미러입니다. 메인 엔진이 진실의 원천(source of truth)이며, 여기의 골든 테스트는 이 미러를 동일한 공개 예제에 고정합니다. 버그 보고는 언제나 환영합니다. 위의 관례를 변경하는 PR은 거절됩니다 (관례 포크는 공개된 방법론을 거짓으로 만들기 때문입니다).

MIT © Shan Liu