Caelus Mcp

io.github.heavyblottov0.24.1更新於 Oct 7, 2026

34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.

已驗證Streamable HTTP可網頁執行Other

概覽

AI 產生的概覽

一個提供 34 個工具的占星 MCP 伺服器，可計算星曆位置、本命盤、行運、吠陀方法以及可引用的星盤事實。

功能: Caelus 提供 34 個 MCP 工具用於經過驗證的占星計算：星曆位置、本命盤與合盤、行運、事件與食相、希臘化擇時技法、吠陀方法、可引用的星盤事實，以及天空視圖圖像提示框架。它也提供由公有領域釋義語料支援的 interpret() 功能。引擎是零相依性的 TypeScript 套件，Python 參考引擎僅用於產生係數資料與測試 fixture。
適用情境: 當助理需要產生或核對占星計算結果而非憑空推測時值得加入，例如本命盤、行運，或吠陀與希臘化技法。當星盤輸出需要可引用或可重現，或需要為圖像生成提供天空視圖框架時也有用。
執行需求: 可作為 ephemengine.com 上的遠端 streamable HTTP 端點執行，也可作為本機 npm 套件（caelus-mcp）透過 stdio 執行，因此本機安裝需要 Node.js。未宣告任何身分驗證、環境變數或標頭。該儲存庫也會建置一個 Next.js 網站應用與邊緣星盤 API 供本機使用。

安裝前請注意

未宣告任何憑證、付款或寫入操作。星盤結果取決於所提供出生時間與地點的準確性，且專案說明與 Swiss Ephemeris 的比較在 0.5.0 版本結束，因此在依賴輸出前應與其他可信來源核對。

安裝

在 SourceWeft 中

開啟儀表板中的 Caelus Mcp，將其新增到工作區。
為需要使用其工具的對話啟用該服務。

Web executable，透過 Streamable HTTP。遠端服務在工作區中設定後即可從網頁執行環境執行。

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "caelus-mcp": {
      "type": "http",
      "url": "https://www.ephemengine.com/api/mcp"
    }
  }
}

README

Caelus

Clean-room astrology computation monorepo. MIT, no Swiss Ephemeris code, no AGPL, no ephemeris files. Caelus computes ephemeris positions, charts, events, hellenistic timing techniques, Vedic methods, citable chart facts, sky-view image-prompt frames, and the MCP tools around them. Live at ephemengine.com.

Packages

Path	npm	Description
`packages/caelus`	`caelus`	TypeScript engine (~153 KB gzipped total, zero deps)
`packages/caelus-mcp`	`caelus-mcp`	MCP server: charts, transits, synastry, events, eclipses
`packages/caelus-delineations-pd`	—	Public-domain interpretation corpus + default validation set for `interpret()`
`packages/birth`	`caelus-birth`	Birth time + place → UT (timezone and DST resolution)
`packages/wheel`	`caelus-wheel`	React SVG chart wheel, zero runtime deps
`apps/web`	—	Next.js site: playground, validation, edge `/api/chart`
`caelus-starter`	—	Next.js starter app (separate repo)

The Python reference engine and data-fitting pipeline live in python/; they mint the coefficient data and golden fixtures and are not a runtime dependency.

Docs

ARCHITECTURE.md — layout, durability decisions, product strategy
MCP_SPEC.md — MCP tool contract
docs/gap-analysis.md — Swiss Ephemeris comparison (closed at 0.5.0)
docs/agents.md — pitfalls for coding agents building on Caelus
docs/releasing.md — release process

Quick start

http://localhost:3000 — live chart in the browser. Edge API: GET /api/chart?date=…&lat=…&lon=….

Branches

main — stable releases
dev — active development

來源：README.md，提交 b5631d4

工具

工具後設資料尚未被收錄。

版本歷史

v0.24.1最新Sep 16, 2026