Auseklis Astrology

auseklis

占星術 MCP サーバー — ネイタルチャート、トランジット、シナストリー、プログレス、リターン、食、逆行、月相に対応します。実際の天文暦を使って計算するため、AI エージェントが惑星の位置を幻覚することはありません。

ラトビア語で「明けの明星」にちなんだ名前です。AGPL の天文暦データは含まない MIT ライセンスです — 詳細はライセンスをご覧ください。

ツール

ツール	機能
get_planet_position	ある時点の天体／感受点の位置（サイン、度数、速度、逆行）
compute_natal_chart	完全な出生図：13 の感受点、ハウス、アングル、幸運点、アスペクト
compute_transits	現在（または任意の）の天空から出生図へのアスペクト
compute_progressions	セカンダリー・プログレッション（1 日を 1 年として計算）
compute_synastry	2 人の人物のチャート間のアスペクト
compute_composite_chart	関係性のミッドポイント・コンポジットチャート
find_returns	太陽／月／惑星のリターン（正確な時刻）
get_moon_phase	月相、照度、月のサイン、次の 4 つの四半期
find_eclipses	サインと現地での観測可能性を含む月食／日食
find_retrograde_periods	任意の惑星の逆行／順行の留の時刻
find_sign_ingresses	天体がサインを移動する時刻（分点、土星のサイン移動など）
find_aspect_times	トランジットが正確に形成される時刻（「土星が私の太陽とスクエアになるのはいつ？」）

さらに、2 つのプロンプト（natal_chart_reading、current_sky_report）と用語集リソース（auseklis://glossary）があります。

機能： IANA タイムゾーンを使った現地出生時刻（過去の夏時間も完全に処理） · トロピカル方式とサイデリアル方式（ラヒリ、フェイガン／ブラッドリー）の黄道 · ホールサイン、イコール、ポーフィリー、プラシーダスのハウス方式 · 平均月交点とブラックムーン・リリス · 幸運点（古典的な昼夜の計算式）。

インストール

Claude Code

claude mcp add auseklis -- npx -y auseklis

Claude Desktop／任意の MCP クライアント（stdio）

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

API キーも設定も不要です — 天文暦はローカルで計算されます。

デスクトップ拡張機能

リリースページからauseklis.mcpbをダウンロードし、ダブルクリックして Claude Desktop にインストールします。または、npm run bundleで自分でビルドできます。

リモート（セルフホスト）

同じサーバーを、Streamable HTTP を使用する Cloudflare Worker として実行できます。ご自身のアカウントにデプロイしてください。

npm run deploy   # wrangler deploy
claude mcp add --transport http auseklis https://auseklis.<your-subdomain>.workers.dev/mcp

ベアラートークンを必須にするには、MCP_SHARED_SECRETシークレットを設定してください。

ライブラリの使用

天文暦のコア（src/ephemeris/以下のすべて）は直接インポートでき、MCP クライアントやサブプロセスは必要ありません。リクエストごとにnpx auseklisを起動できないサーバーレスランタイム（Vercel、Workers）では、この方法が適しています。

import { computeNatalChart } from "auseklis/ephemeris";
import { findRetrogradePeriods } from "auseklis/ephemeris/events";
import { findEclipses } from "auseklis/ephemeris/eclipses";

const chart = computeNatalChart({
  utc: "1990-03-15T13:45:00Z",
  location: { latitude: 56.95, longitude: 24.11 }, // Riga
  houseSystem: "placidus",
});

auseklis/ephemerisにはチャート計算（ネイタル、トランジット、シナストリー、コンポジット、プログレス、単独の位置、アングル）と、現地時間から UTC への変換を行うresolveInstantが含まれます。時間領域の検索機能は…/eventsと…/eclipsesに含まれます。型定義が完備され、ESM のみで、データファイルはありません。

質問例

• 「私のネイタルチャートを計算してください — 1990 年 3 月 15 日 15:45、リガ生まれです。」
• 「今月、私の太陽にどんなトランジットがありますか？」
• 「私の土星回帰は正確にはいつですか？」
• 「私とパートナーのシナストリーを見てください。」（2 人分の生年月日と時刻）
• 「2027 年の水星逆行はいつですか？どのサインで起こりますか？」
• 「今夜の満月は、ここから食として見えますか？」

地名から座標への変換はモデルが行い、現地時間から UTC への変換はサーバーが IANA タイムゾーンデータベースを使って行います。

精度

位置の計算にはastronomy-engine（VSOP87 + NOVAS C 3.1）を使用しています。1700～2200 年の誤差は ±1 角分で、占星術の解釈で使われる 1° の分解能を大きく下回ります。イベント検索（留、サイン移動、リターン、四半期）は約 1 秒の精度まで絞り込まれます。公開済みの日食日付、2026 年の分点、NOVAS の太陽位置、独立したプラシーダス実装と照合し、CI で検証しています。

アーキテクチャ

src/
├── ephemeris/        Astrology core — backend-agnostic
│   ├── engine.ts     EphemerisBackend interface + astronomy-engine adapter (the swap seam)
│   ├── index.ts      Charts, aspects, synastry, composite, progressions
│   ├── events.ts     Time searches: returns, stations, ingresses, aspect times, moon phases
│   ├── eclipses.ts   Eclipse searches with astrological context
│   ├── houses.ts     Whole-sign, equal, Porphyry, Placidus (semi-arc solver)
│   ├── points.ts     Mean lunar nodes, Black Moon Lilith
│   ├── sidereal.ts   Ayanamsa (Lahiri, Fagan/Bradley)
│   └── time.ts       IANA timezone → UTC conversion (no dependencies, uses Intl)
├── mcp/              Tool/prompt/resource definitions on @modelcontextprotocol/sdk
├── stdio.ts          Local entry — `npx auseklis`
└── index.ts          Remote entry — Cloudflare Worker, Streamable HTTP via @hono/mcp

engine.tsにあるEphemerisBackendインターフェースは、意図的に設けた差し替え箇所です。将来、Rust/WASM によるクリーンルーム方式の天文暦を導入する場合も、このインターフェースだけを再実装すれば済みます。

開発

npm install
npm run typecheck   # strict TS
npm test            # 23-check smoke suite (ephemeris references + MCP end-to-end)
npm run build       # emit dist/
npm run dev         # local Cloudflare Worker on :8787
npx @modelcontextprotocol/inspector node dist/stdio.js   # poke tools interactively

ツールの全リファレンスについてはdocs/tools.mdを、設計に関する説明についてはdocs/architecture.mdをご覧ください。

ライセンス

MITです。このプロジェクトでは、Swiss Ephemeris（.se1／.se2 データファイルとswephバインディング）を意図的に使用していません。これらはAGPLライセンスのため、それらを利用して構築するあらゆるネットワークサービスにAGPLの義務が課されることになります。ここにあるものはすべて、外部データファイルを使わずにMITライセンスのコードから計算されるため、組み込み、フォーク、商用展開を安全に行えます。詳細はNOTICEをご覧ください。

その代わり、カイロンや小惑星には対応していません（天体暦データファイルが必要です）。これらは、パブリックドメインのJPL由来データを通じてロードマップに追加する予定です。

ロードマップ

• v1：同じEphemerisBackendの境界の背後に、Rust/WASMによるクリーンルームの天体暦バックエンドを実装
• パブリックドメインのJPLデータに基づくカイロンと主要な小惑星
• コッホハウス方式、赤緯／パラレルアスペクト