Caelus Mcp

FreeNot checked

MCP server for Caelus astrology computation: charts, transits, timing techniques, Vedic methods, and citable chart facts.

by jkrane

GitHub Embed

About

MCP server for Caelus astrology computation: charts, transits, timing techniques, Vedic methods, and citable chart facts.

README

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 (~97 KB gzipped, 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

npm install
npm run build
npm test
npm run dev -w web

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

Branches

main — stable releases
dev — active development

from github.com/heavyblotto/caelus

Install Caelus Mcp in Claude Desktop, Claude Code & Cursor

Recommended · one command, every IDE

unyly install caelus-mcp

Installs into Claude Desktop, Claude Code, Cursor & VS Code — handles npx, uvx and build-from-source repos for you.

First time? Get the CLI: curl -fsSL https://unyly.org/install | sh

Or configure manually

Run in your terminal:

claude mcp add caelus-mcp -- npx -y caelus-mcp

FAQ

Is Caelus Mcp MCP free?

Yes, Caelus Mcp MCP is free — one-click install via Unyly at no cost.

Does Caelus Mcp need an API key?

No, Caelus Mcp runs without API keys or environment variables.

Is Caelus Mcp hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Caelus Mcp in Claude Desktop, Claude Code or Cursor?

Open Caelus Mcp on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

GitHub

PRs, issues, code search, CI status

by GitHub

Filesystem

Secure file operations with configurable access controls.

by Community

Memory

Knowledge graph-based persistent memory system.

by Community

Template MCP Server

A CLI tool to create a new Model Context Protocol server project with TypeScript support, dual transport options, and an extensible structure

by mcpdotdirect

Compare Caelus Mcp with

Caelus McpvsGitHub Caelus McpvsFilesystem Caelus McpvsMemory Caelus McpvsTemplate MCP Server

Not sure what to pick?

Find your stack in 60 seconds

Author?

Embed badge for your README

Browse similar

All development MCPs