
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.
概覽
以真實星曆表計算本命盤、行運、合盤、回歸與食相的占星 MCP 伺服器,讓助理不再憑空猜測行星位置。
- 可以做什麼
- 計算位置與星盤:單一星體位置、含宮位與相位的完整本命盤、二次推運、合盤與組合盤
- 分析行運:目前或任意時刻天空對本命盤的相位,以及相位精確成相的時點
- 查找定時事件:日、月及行星回歸,逆行停滯點、星座換座、月相,以及含當地可見性的食相
- 套用星盤設定:含歷史日光節約時間的 IANA 時區、回歸或恆星黃道、多種宮位制、月交點與莉莉絲
- 使用內建提示詞產生本命盤解讀或目前天象報告,並提供術語表資源
- 適用情境
- 當你希望助理依據真實星曆計算給出占星星盤與事件時間,而不是編造行星位置時使用,例如出生星盤、土星回歸日期,或某年的水星逆行時段。
- 執行需求
- 透過 stdio 在本機執行,通常以 Node.js 搭配 npx 啟動;不需要 API 金鑰或設定。文件另介紹自架的 Cloudflare Worker 部署方式,可選擇以 MCP_SHARED_SECRET 作為 bearer 權杖保護。座標須由模型提供,伺服器只負責將當地時間轉為 UTC。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Auseklis Astrology,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
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
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
Claude Desktop / any MCP client (stdio)
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:
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:
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
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
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
EphemerisBackendseam - Chiron + major asteroids from public-domain JPL data
- Koch houses, declination/parallel aspects
來源:README.md,提交 57e6417
工具
0版本歷史
1- v0.4.0最新Sep 16, 2026
評分
已滿足適用檢查項的 50%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分