
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 分