true-solar-time-mcp

八字（四柱）命盤のための真太陽時補正 — ほとんどの計算ツールが飛ばしているステップ。

記録された出生時刻（壁時計 + IANAタイムゾーン + 経度）を、出生地における太陽の実際の時刻に変換するMCPサーバー、CLI、およびTypeScriptライブラリです。決定的：同じ入力からは常に同じ出力が得られます。

$ 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「スキル」を含む）が黙って飛ばしている3つの補正があります：

1. 歴史的な夏時間。 中国は1986年から1991年まで夏時間を実施していました。この6年間の夏に生まれた人は、出生証明書に1時間進んだ時計が記録されています — これは丸ごと1つの時辰を跨ぐのに十分であり、夜の適切な時刻には日柱も跨ぎます。IANA/ICUタイムゾーンデータベースはこれを知っていますが、ほとんどの計算ツールはそれに問い合わせることすらしません。

2. 経度。 中国は4つの地理的なタイムゾーンにまたがり、1つの時計で運用されています。ウルムチの北京時間07:10では、現地の太陽時はようやく05:00を過ぎたばかり — 丸ごと2つの時辰分の差があります。

3. 均時差。 真太陽時と平均太陽時は、1年の間に最大±16分ずれます（ここではNOAA近似を使用、誤差は1分未満）。11月初旬には、これだけで命盤が時辰の境界を越えることがあります。

このライブラリはまた、ほとんどのツールが教えてくれない2つのことも報告します：

• あなたの出生時刻が実際に存在したかどうか。 春先の時計が進む夜には、現地の時計は01:59から03:00にジャンプします。02:30という出生記録は実際の瞬間を指していません。私たちはそのギャップを検出し、その幅を報告し、黙って推測することは決してありません。

• 補正後の時刻が時辰の境界にどれだけ近いか。 数分以内であれば、正直な答えは「両方の候補で命盤を作成する」ことであり、偽りの精度ではありません。

Related MCP server: BaZi (Eight Characters) Calculator

意図的に行わないこと

命盤を作成したり、有利な要素を選んだり、何かを解釈したりはしません。命盤作成は優れたオープンソース実装がある解決済みの問題です。解釈には唯一の正解がなく、ルックアップライブラリに属するものではありません。1つのステップを、注意深く行います。

完全な方法論 — すべての定数、閾値、慣例（このライブラリが使用するものを含む）は、auspiceoracle.com/en/method で公開されています。完全な導出を含む3つの実例：出生時刻テスト。背景エッセイ：真太陽時。

MCPサーバー

ホスト型エンドポイント（インストール不要）： https://auspiceoracle.com/mcp — ステートレスなストリーミング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 — 完全な補正：補正後の瞬間、夏時間/経度/均時差の内訳（3つは常に合計が総補正と正確に一致）、時辰、境界距離、存在しない時刻の検出。

• hour_branch — すでに補正された時刻に対する時辰の所属と境界距離。

ホスト型エンドポイントはさらに cast_pillars を公開しています — 太陽時補正された四柱（隠れた天干、納音、大運を含む）を、本番のAuspice Oracleエンジン（クローズドソース、公開された方法論と同じ慣例）で計算します。事実のみ — 強弱の判定も解釈もありません。

八字スキルやエージェントを構築している場合：true_solar_time を キャスティングの前に 呼び出し、補正された時刻をキャスターに渡してください。LLMはこの変換をコンテキスト内で行うことはできません — 均時差は三角級数であり、夏時間の歴史はデータベースにあり、モデルの重みにはありません。

ライブラリ

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年）、内訳 の夏時間/経度の分割は不完全に帰属することがあります。総補正は常に実際のオフセットから計算され、影響を受けません。

auspiceoracle.comとの関係

これは、Auspice Oracle の背後にあるエンジンの太陽時レイヤーの抽出ミラーです。メインエンジンが真実の源であり、ここでのゴールデンテストはこのミラーを同じ公開された例に固定します。バグ報告は大歓迎です。上記の慣例を変更するPRは拒否されます（慣例のフォークは公開された方法論を不正確にするため）。

MIT © Shan Liu