Auseklis Astrology

io.github.igmizo由 GitHub 帳號 igmizo 發布v0.4.0更新於 Nov 10, 2026

Astrology from a real ephemeris: natal charts, transits, synastry, eclipses, returns. No API keys.

已驗證STDIO僅桌面

概覽

AI 產生的概覽

以真實星曆表計算本命盤、行運、合盤、回歸與食相的占星 MCP 伺服器,讓助理不再憑空猜測行星位置。

可以做什麼
  • 計算位置與星盤:單一星體位置、含宮位與相位的完整本命盤、二次推運、合盤與組合盤
  • 分析行運:目前或任意時刻天空對本命盤的相位,以及相位精確成相的時點
  • 查找定時事件:日、月及行星回歸,逆行停滯點、星座換座、月相,以及含當地可見性的食相
  • 套用星盤設定:含歷史日光節約時間的 IANA 時區、回歸或恆星黃道、多種宮位制、月交點與莉莉絲
  • 使用內建提示詞產生本命盤解讀或目前天象報告,並提供術語表資源
適用情境
當你希望助理依據真實星曆計算給出占星星盤與事件時間,而不是編造行星位置時使用,例如出生星盤、土星回歸日期,或某年的水星逆行時段。
執行需求
透過 stdio 在本機執行,通常以 Node.js 搭配 npx 啟動;不需要 API 金鑰或設定。文件另介紹自架的 Cloudflare Worker 部署方式,可選擇以 MCP_SHARED_SECRET 作為 bearer 權杖保護。座標須由模型提供,伺服器只負責將當地時間轉為 UTC。
安裝前請注意
僅做唯讀計算;未提及帳號、付費或儲存個人資料。出生日期、時間與地點屬於個人資料並會傳給工具;自架遠端部署應設定 MCP_SHARED_SECRET 以要求 bearer 權杖。不提供凱龍星與小行星。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Auseklis Astrology,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

auseklis

Astrology MCP server — natal charts, transits, synastry, progressions, returns, eclipses, retrogrades, moon phases. Computed from a real ephemeris, so AI agents stop hallucinating planet positions.

Named after the Latvian morning star. MIT-licensed with no AGPL ephemeris data — see Licensing.

Tools

ToolWhat it does
get_planet_positionPosition of one body/point at a moment (sign, degree, speed, retrograde)
compute_natal_chartFull birth chart: 13 points, houses, angles, Part of Fortune, aspects
compute_transitsAspects from the current (or any) sky to a natal chart
compute_progressionsSecondary progressions (day-for-a-year)
compute_synastryCross-chart aspects between two people
compute_composite_chartMidpoint composite chart of a relationship
find_returnsSolar/lunar/planetary returns (exact moments)
get_moon_phasePhase, illumination, Moon sign, next four quarters
find_eclipsesLunar/solar eclipses with signs, incl. local visibility
find_retrograde_periodsStation retrograde/direct moments for any planet
find_sign_ingressesWhen a body changes signs (equinoxes, Saturn ingresses, …)
find_aspect_timesExact moment a transit perfects ("when does Saturn square my Sun?")

Plus two prompts (natal_chart_reading, current_sky_report) and a glossary resource (auseklis://glossary).

Features: local birth times with IANA timezones (full historical DST handling) · tropical and sidereal (Lahiri, Fagan/Bradley) zodiacs · whole-sign, equal, Porphyry, and Placidus houses · mean lunar nodes and Black Moon Lilith · Part of Fortune (classical day/night formula).

Installation

Claude Code

bash
claude mcp add auseklis -- npx -y auseklis

Claude Desktop / any MCP client (stdio)

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

No API keys, no configuration — the ephemeris is computed locally.

Desktop Extension

Download auseklis.mcpb from the releases page and double-click to install in Claude Desktop. Or build it yourself: npm run bundle.

Remote (self-hosted)

The same server runs as a Cloudflare Worker speaking Streamable HTTP. Deploy it to your own account:

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

Set the MCP_SHARED_SECRET secret to require a bearer token.

Library usage

The ephemeris core (everything under src/ephemeris/) is importable directly — no MCP client or subprocess needed. This is the right shape for serverless runtimes (Vercel, Workers), where spawning npx auseklis per request is not an option:

ts
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 carries the chart math (natal, transits, synastry, composite, progressions, single positions, angles) plus resolveInstant for local-time → UTC conversion; …/events and …/eclipses carry the time-domain searches. Fully typed, ESM only, no data files.

Example questions to ask

  • "Compute my natal chart — born 15 March 1990, 15:45 in Riga."
  • "What's transiting my Sun this month?"
  • "When exactly is my Saturn return?"
  • "Synastry between me and my partner?" (two birth date/times)
  • "When is Mercury retrograde in 2027, and in which signs?"
  • "Is tonight's full moon visible as an eclipse from here?"

The model handles place-name → coordinates; the server handles local-time → UTC via the IANA timezone database.

Accuracy

Positions come from astronomy-engine (VSOP87 + NOVAS C 3.1): ±1 arcminute for 1700–2200, far below the 1° resolution astrological interpretation uses. Event searches (stations, ingresses, returns, quarters) are refined to ~1 second of time. Verified in CI against published eclipse dates, the 2026 equinox, NOVAS Sun positions, and an independent Placidus implementation.

Architecture

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

The EphemerisBackend interface in engine.ts is the deliberate swap seam: a future Rust/WASM clean-room ephemeris only needs to reimplement that one interface.

Development

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

See docs/tools.md for the full tool reference and docs/architecture.md for design notes.

Licensing

MIT. This project deliberately avoids the Swiss Ephemeris (.se1/.se2 data files and the sweph bindings): those are AGPL-licensed, which would impose AGPL obligations on any network service built on them. Everything here is computed from MIT-licensed code with no external data files — safe to embed, fork, and deploy commercially. Details in NOTICE.

The trade-off: no Chiron or asteroids (they need ephemeris data files). They are on the roadmap via public-domain JPL-derived data.

Roadmap

  • v1: Rust/WASM clean-room ephemeris backend behind the same EphemerisBackend seam
  • Chiron + major asteroids from public-domain JPL data
  • Koch houses, declination/parallel aspects

來源:README.md,提交 57e6417

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v0.4.0最新Sep 16, 2026

評分

已滿足適用檢查項的 50%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分