deepnatal

deepnatal

すべての結果を独立した3つの方法で相互検証し、検証できない場合は回答を拒否するネイタルチャートエンジンです。

TypeScript ライブラリとしても、Claude、Cursor、Codex、Cline などのエージェント向けの MCP サーバーとしても提供されます。

npx -y deepnatal-mcp

これが作られた理由

どの占星術サイトに出生図を尋ねても、答えは返ってきます。しかし、その答えを検証する方法が示されることはほとんどありません。

これは思っている以上に重要です。アセンダント、つまり上昇宮は4分ごとに約1度移動します。UTC の時刻を1時間間違えると、約半星座分ずれてしまいます。それでも結果は一見もっともらしく見えます。間違いを示すものは何もありません。

そして、1時間ずれるのは簡単です。台湾では1945～1961年と1974～1979年に夏時間が実施されていました。中国本土では1986～1991年、日本では1948～1951年に実施されていました。多くのツールは1988年の出生日時に、何の説明もなく 現在の UTC オフセットを適用し、ちょうど1時間ずれたチャートを返します。

このパッケージは、正反対の前提に基づいて作られています。検証できない結果は、結果とは呼べません。

検証の仕組み

すべてのチャートを独立した3つの経路で計算します。食い違いは平均化して解消するものではなく、エラーです。

実際の計算では、通常1分角未満の精度で一致します。許容範囲を超えると、チャートを返すのではなく呼び出し時にエラーが発生します。

数学的に実際の限界がある場合も、誠実に対処します。

• 緯度66°超ではプラシーダスハウスが定義されません。エンジンはホールサイン方式に切り替え、そのことを明示します。何も知らせずに意味のない結果を出すことはありません。
• 出生時刻がない場合は、アセンダント、ミッドヘブン、ハウスを理由とともに省略します。正午で代用することはありません。その日に月が星座を移動した場合（全日付のほぼ半数で起こります）、そのことも報告します。
• 夏時間への切り替えで生じる時間のギャップ、つまり現地時刻が存在しない、または2回発生する場合は、エラーを返して時刻の特定を求めます。

ご自身で検証する

「相互検証済み」と README に書いてあるだけでは、何の証明にもなりません。このテストスイートは公開済みパッケージに含まれているため、インストールしたものとまったく同じファイルに対して実行できます。

npm i deepnatal
node node_modules/deepnatal/dist/selftest.js

✅ PASS — 21/21 boundary cases + 11/11 external cross-checks
   All three paths agree, and they agree with an outside source.

21件の境界ケースは、簡単なものではなく、問題を引き起こすケースを選んでいます。中国の1986～1991年の夏時間期間と、同じ年の冬の対照ケース、台湾の1979年、日本の GHQ 占領期にあたる1948～1951年、夏時間の切り替えで存在しなかった時刻、そしてプラシーダスが定義されない北極圏内の緯度が含まれます。

11件の外部チェックでは、astro-seek から取得した値と比較します。これは、内部の3つの経路が、トロピカル方式、見かけの地心位置、日付時点の真黄道という前提を共有しているためです。前提そのものが誤っていた場合、3つの経路すべてが同じ誤った答えを出す可能性があります。それを検出できるのは外部ソースだけです。

CI では、意図的に UTC 以外のシステム時刻を設定し、Node 20/22/24 でテストスイートを実行します。これにより、ホストのタイムゾーンへの意図しない依存があれば、明確に失敗します。

クイックスタート

npm install deepnatal

import { calculateNatalChart, verifyAscendant } from 'deepnatal';

const birth = {
  date: '1988-07-15',
  time: '14:30',
  timezone: 'Asia/Shanghai',   // the BIRTHPLACE's zone, never the user's current one
  latitude: 31.23,
  longitude: 121.47,
};

const chart = calculateNatalChart(birth);
chart.ascendant;             // { sign: 'scorpio', degreeInSign: 10.37, ... }
chart.crossCheckMaxArcmin;   // 0.467 — how far the two engines disagreed

他のツールの回答を検証する

このパッケージが存在する理由です。他のツールの結果を claim として渡します：

verifyAscendant(birth, 'Scorpio 23.0');

{
  "computed":  { "sign": "scorpio", "degreeInSign": 10.37 },
  "geometric": { "sign": "scorpio", "degreeInSign": 10.37 },  // independent path
  "internalAgreementArcmin": 0,
  "oneHourOffsetTest": {
    "minusOneHour": { "sign": "libra",   "degreeInSign": 27.66 },
    "plusOneHour":  { "sign": "scorpio", "degreeInSign": 22.98 },
    "degreesPerHour": 12.66
  },
  "claim": {
    "verdict": "off-by-one-hour",
    "likelyCause": "Measured, not guessed: the supplied value matches this engine's
                    ascendant for a birth instant one hour LATER than the one given..."
  }
}

degreesPerHour: 12.66 に注目してください。一般的な経験則では、1時間で15°とされています。これは地球の自転速度であり、黄道に沿って移動する上昇点の速度ではありません。この2つが一致するのは赤道付近だけです。このライブラリはそれを前提とせず、チャートごとに速度を測定します。

MCP サーバー

npx -y deepnatal-mcp

{
  "mcpServers": {
    "deepnatal": { "command": "npx", "args": ["-y", "deepnatal-mcp"] }
  }
}

{
  "mcpServers": {
    "deepnatal": { "command": "npx", "args": ["-y", "deepnatal-mcp"] }
  }
}

claude mcp add deepnatal -- npx -y deepnatal-mcp

ツール

すべてエージェント自身のプロセス内でローカルに実行されます。出生データは扱う個人データの中でも特に機微な情報ですが、データがマシンの外に出ることはありません。このパッケージ内にネットワーク呼び出しは一切ありません。

エージェントに推論させるのではなく、このツールを呼び出させるのはなぜですか？ 上昇星座を算出するよう言語モデルに求めると、自信に満ちた、もっともらしい誤答を返すことがあり、その誤りを後続の処理で検出できないからです。このサーバーは計算した事実と、それ自体の不確実性を返します。解釈は一切行いません。

中文說明

deepnatal 是一套會自我驗算的本命盤計算引擎——算不出來時它會拒絕回答，而不是給你一個看起來合理的答案。

上升星座每四分鐘移動約一度。時區算錯一小時，上升就偏掉大半個星座，而結果看起來完全正常，不會有任何地方提示你它是錯的。

而一小時很容易丟。台灣在 1945–1961、1974–1979 實施過夏令時間，中國大陸是 1986–1991，日本是 1948–1951。不少工具會把今天的時區偏移直接套到 1988 年的出生日期上。

三條獨立路徑同時計算，彼此不一致就報錯：

1. 時區層　明確 IANA 時區 + Node ICU 歷史 tzdata，與座標反查時區交叉核對
2. 行星層　circular-natal-horoscope-js × astronomy-engine 兩套獨立演算法
3. 上升層　純球面幾何第三條路（黃道與東方地平線交點），完全不依賴任何占星函式庫

實測吻合度在 1 角分以內。超過容許值就丟出錯誤，不回傳星盤。

verifyAscendant() 可以用來檢查任何其他工具算出的上升是否正確。它不猜原因——而是實際重算前後各一小時的上升點，如果對方的答案正好落在那裡，就能證明差異來自時區處理而非天文計算。

完整工具與說明見 deepnatal.com。

このツールで証明できないこと

限界を率直に示すことも、このツールの目的の一部です。

• 相互検証によって実装上のバグやずれを検出できます。しかし、共通の規約が正しいことまでは証明できません。3つの計算経路はすべて、トロピカル方式の黄道帯、見かけの地心位置、当日の真黄道を前提としています。
• 再現可能なチャートであっても、占星術に予測能力があることを示すものではありません。このパッケージは天体位置を計算します。意味については何も主張しません。
• ハウスシステム、黄道帯（トロピカル方式とサイデリアル方式）、天体暦、ノードの規約、丸め方の違いによって、2つのツールの結果が正当に異なることがあります。verify_ascendant は1時間のずれをこうした違いと区別しますが、規約の違いについてどちらが正しいかを判定するものではありません。
• 出生データが間違っていれば、誤った時点のチャートが技術的には正しく計算されます。後続の処理でそれを補うことはできません。

ライセンス

MIT。再配布しやすいよう、依存関係は意図的に明確にしています：

特筆すべき点として、Swiss Ephemeris（sweph／swisseph）は使用していません。デュアルライセンスの AGPL-3.0-or-later OR LGPL-3.0-or-later という表記は誤解を招きます。LGPL の選択肢を利用するには、事前にAstrodienstの商用ライセンスを購入する必要があります。購入しなければAGPLが適用され、ネットワークサービスにも及び、これに触れるすべてのものをオープンソース化する必要があります。この制約があるため、ホスト型の占星術サービスの多くは計算レイヤーをオープンなパッケージとして公開できません。このパッケージではそれが可能です。

クレジット

これはdeepnatal.comの計算レイヤーをそのまま抽出したものです。サイトではここに同梱されているものと同じコードが実行されるため、サイトで作成されたチャートはすべて、このパッケージを使ってローカルで再現できます。

イシューとプルリクエスト：github.com/breezefeng/deepnatal