
Astro
io.github.aryaminus由 GitHub 帳號 aryaminus 發布v2.4.0更新於 Oct 24, 2026
Multi-tradition astrology. 19 modes, 18 tools. Deterministic ephemeris engine.
概覽
本機星象運算引擎,依西方、吠陀與中式八字傳統計算真實出生盤、行運與合盤,供助理解讀
- 可以做什麼
- 依出生資料與經緯度計算本命盤、行運、回歸盤、推運與行星時,19 種模式、18 個工具,預設附帶相位格局、阿拉伯點與恆星。比對兩張盤做合盤、相容度與組合盤解讀,並給出 0–100 評分。產生吠陀分盤、曆法(panchang)資料與中式八字四柱結果。用占星地理圖分析地點,用擇日與曆法工具挑選日期或時辰。輸出結構化 JSON,由模型依隨附的古典規則集解讀,而非憑空猜測星位。
- 適用情境
- 適合希望助理根據實際運算出的星位、而非編造資料來回答占星問題:本命解讀、關係合盤、時機問題、擇吉日,或搬遷與事業地點分析。
- 執行需求
- 以本機程序在桌面執行。引擎為純 Python、無第三方相依,需要 Python 3 解譯器;README 另提供技能命令列、打包發行版或 git 複製等安裝方式。必須提供出生日期、緯度、經度與 IANA 時區,出生時間可選。文中另提到一個公開遠端端點作為替代。
安裝
在 SourceWeft 中
- 開啟 儀表板中的 Astro,將其新增到工作區。
- 為需要使用其工具的對話啟用該服務。
Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。
其他 MCP 客戶端
參照 儲存庫 中的啟動說明。
README
Astro — Multi-Tradition Astrology Engine for AI Agents
Trustworthy birth charts, transits, and synastry across Western, Vedic/Jyotish, and Chinese BaZi. The engine computes; the model interprets.
[MIT] [Python 3.10+] [MCP] [REST] [Deploy] [smithery badge]
Paste this into any AI chat or agent (Claude, ChatGPT, Gemini, Claude Code, Cursor, Codex, DeepSeek, Perplexity…). It installs Astro itself — you don't set anything up first:
Local install — works on Claude Code, Cursor, Codex, Copilot, Gemini CLI, and 50+ Agent Skills hosts:
Why this exists
A raw LLM cannot tell you where Mars was on a Tuesday in 1997 — it hallucinates chart data. Astro splits the work:
- Engine — deterministic Python math computes real sky positions (zero deps, pure stdlib)
- Skill — orchestrates the engine + loads classical interpretation rulesets
- Glue — MCP, REST, CLI, ChatGPT Actions reach the engine from any platform
The model never guesses a position. It interprets structured output grounded in 8 classical rulesets.
19 modes · 3 traditions · zero dependencies
Modes: natal, transit, synastry, compatibility, composite, astrocartography, horary, event, solar/lunar/planetary return, navamsa, varga (D2–D60), panchang, moon phase, numerology, progressions, planetary hours, transit-to-natal aspects. Full list and parameters in skills/astrology/SKILL.md.
Traditions: Western tropical, Vedic/Jyotisha (Lahiri sidereal), Chinese BaZi + Tibetan/Buddhist.
Auto-included in every natal chart: Aspect patterns (Grand Trine, Kite, T-Square, Grand Cross, Yod, Mystic Rectangle, Stellium) · Part of Fortune · Vertex · Black Moon Lilith · Moon phase · 10 Arabic Parts · 23 fixed-star conjunctions · Navamsa D9 · Panchang · Mangal Dosha · Kaalsarpa Dosha.
Try it
After installing, ask any of these:
- "What's my chart?" → full natal
- "Am I compatible with…?" → synastry + 0–100 scoring
- "When's my Saturn return?" → planetary return + timing
- "Where should I live for career?" → astrocartography
- "What time should I start the meeting?" → Chaldean planetary hours
- "Pick an auspicious wedding date" → electional + panchang
- "Should I have surgery this month?" → medical timing
- "What does today have in store?" → transits + natal aspects
Project layout
Cloud hosting
Free by default. No auth, no rate limits. Set ASTRO_API_KEY to gate, ASTRO_RATE_LIMIT to throttle.
Render (one-click, free tier): Connect this repo → New → Blueprint. render.yaml provisions everything. Verify with curl https://astro-api-a2rc.onrender.com/health. Free tier spins down after 15 min idle; first request after idle takes ~30s.
Docker:
Raw Python:
MCP SSE (Smithery, Cloudflare, Poke):
Cloud MCP SSE (no deploy needed): https://astro-api-a2rc.onrender.com/mcp/sse — free Render instance. ~30s cold start.
Env vars and operational endpoints documented in AGENTS.md.
Documentation
Contributing
PRs welcome. Hard rules: engine stays zero-dep, engine never imports frameworks, touch all 4 surfaces (engine + MCP + REST + OpenAPI), the skill is honest. See CONTRIBUTING.md.
License
MIT. Reference texts in skills/astrology/references/ are original MIT-licensed syntheses of classical sources.
來源:README.md,提交 82df4c1
工具
0版本歷史
1- v2.4.0最新Sep 16, 2026
評分
已滿足適用檢查項的 40%
該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。
- 近 30 天內可連通25 分
請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。
- 已宣告認證方式10 分
請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。
- 已列出工具15 分
請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。
- 描述必需15 分
- 圖示10 分
- 文件15 分
- 授權條款10 分
請在儲存庫或註冊中心條目中宣告授權條款。