Skip to main content
ClaudeWave

Clean-room astrological ephemeris engine (MIT)

MCP ServersOfficial Registry0 stars0 forksTypeScriptMITUpdated today
Install in Claude Code / Claude Desktop
Method: Manual
Claude Code CLI
git clone https://github.com/heavyblotto/caelus
claude_desktop_config.json (Claude Desktop)
{
  "mcpServers": {
    "caelus": {
      "command": "node",
      "args": ["/path/to/caelus/dist/index.js"]
    }
  }
}
1. Run the command above in your terminal (Claude Code), or paste the JSON config into claude_desktop_config.json (Claude Desktop).
2. Replace any <placeholder> values with your API keys or paths.
3. Restart Claude. The MCP server and its tools appear automatically.
💡 Clone https://github.com/heavyblotto/caelus and follow its README for install instructions.
Use cases

MCP Servers overview

# Caelus

Astrological ephemeris monorepo. MIT, no Swiss Ephemeris code, no AGPL, no
ephemeris files. Live at [ephemengine.com](https://www.ephemengine.com).

## Packages

| Path | npm | Description |
|------|-----|-------------|
| `packages/caelus` | [`caelus`](https://www.npmjs.com/package/caelus) | TypeScript engine (~85 KB gzipped, zero deps) |
| `packages/caelus-mcp` | [`caelus-mcp`](https://www.npmjs.com/package/caelus-mcp) | MCP server: charts, transits, synastry, events, eclipses |
| `packages/birth` | [`caelus-birth`](https://www.npmjs.com/package/caelus-birth) | Birth time + place → UT (timezone and DST resolution) |
| `packages/wheel` | [`caelus-wheel`](https://www.npmjs.com/package/caelus-wheel) | React SVG chart wheel, zero runtime deps |
| `apps/web` | — | Next.js site: playground, validation, edge `/api/chart` |
| [`caelus-starter`](https://github.com/heavyblotto/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](./ARCHITECTURE.md) — layout, durability decisions, product strategy
- [MCP_SPEC.md](./MCP_SPEC.md) — MCP tool contract
- [docs/gap-analysis.md](./docs/gap-analysis.md) — Swiss Ephemeris comparison (closed at 0.5.0)
- [docs/agents.md](./docs/agents.md) — pitfalls for coding agents building on Caelus
- [docs/releasing.md](./docs/releasing.md) — release process

## Quick start

```bash
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

What people ask about caelus

What is heavyblotto/caelus?

+

heavyblotto/caelus is mcp servers for the Claude AI ecosystem. Clean-room astrological ephemeris engine (MIT) It has 0 GitHub stars and was last updated today.

How do I install caelus?

+

You can install caelus by cloning the repository (https://github.com/heavyblotto/caelus) or following the README instructions on GitHub. ClaudeWave also provides quick install blocks on this page.

Is heavyblotto/caelus safe to use?

+

heavyblotto/caelus has not been audited yet by our security agent. Review the original repository on GitHub before using it in production.

Who maintains heavyblotto/caelus?

+

heavyblotto/caelus is maintained by heavyblotto. The last recorded GitHub activity is from today, with 0 open issues.

Are there alternatives to caelus?

+

Yes. On ClaudeWave you can browse similar mcp servers at /categories/mcp, sorted by popularity or recent activity.

Deploy caelus to your cloud

Ship this repo to production in minutes. Each platform spins up its own environment with editable env vars.

Maintain this repo? Add a badge to your README

Drop the badge into your GitHub README to show it's tracked on ClaudeWave. Each badge links back to this page and reflects the live Trust Score.

Featured on ClaudeWave: heavyblotto/caelus
[![Featured on ClaudeWave](https://claudewave.com/api/badge/heavyblotto-caelus)](https://claudewave.com/repo/heavyblotto-caelus)
<a href="https://claudewave.com/repo/heavyblotto-caelus"><img src="https://claudewave.com/api/badge/heavyblotto-caelus" alt="Featured on ClaudeWave: heavyblotto/caelus" width="320" height="64" /></a>

More MCP Servers

caelus alternatives