io.github.heavyblotto/caelus-mcp
34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'
{
"mcpServers": {
"caelus-mcp": {
"type": "http",
"url": "https://www.ephemengine.com/api/mcp"
}
}
}
caelus-mcpclaude mcp add caelus-mcp -- npx -y caelus-mcp@0.24.1
{
"mcpServers": {
"caelus-mcp": {
"command": "npx",
"args": [
"-y",
"caelus-mcp@0.24.1"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
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
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 releasesdev— active development
Questions fréquentes
Qu'est-ce que io.github.heavyblotto/caelus-mcp ?
34-tool Caelus MCP for validated astrology: charts, transits, Vedic, facts, sky view, synthetic.
Comment installer io.github.heavyblotto/caelus-mcp ?
Il fonctionne comme serveur distant. Dans Claude Code : claude mcp add --transport http caelus-mcp 'https://www.ephemengine.com/api/mcp'. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.heavyblotto/caelus-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.heavyblotto/caelus-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.heavyblotto/caelus-mcp ?
Il est publié par heavyblotto. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.