La plupart des applications d'astrologie laissent une « IA » deviner la position des planètes. Le résultat est plausible… et faux. Chez Llmastro, c'est l'inverse : le ciel est calculé, jamais inventé.
Des positions justes, pas devinées
Les positions planétaires, les maisons et les aspects sont calculés côté serveur par un moteur d'éphémérides astronomiques (Swiss Ephemeris), à partir de votre date, heure et lieu de naissance. Ce n'est qu'ensuite que l'IA met ces données en mots. Le modèle interprète ; il ne calcule jamais le ciel.
C'est un choix de fond : on peut discuter du sens que l'on prête aux astres, mais leur position, elle, est un fait vérifiable. On refuse de le laisser au hasard d'un modèle de langage.
Vérifié contre la NASA
Pour le prouver, nous comparons nos calculs à la référence mondiale : JPL Horizons, le système d'éphémérides du Jet Propulsion Laboratory de la NASA. Voici l'écart de longitude entre notre moteur et Horizons, exprimé en secondes d'arc (1″ = 1/3600 de degré).
| Corps | Écart avec la NASA |
|---|---|
| Soleil | 0,2″ |
| Lune | 1,5″ |
| Mars | 0,2″ |
| Jupiter | 0,1″ |
| Pluton | 0,4″ |
Autrement dit, nos positions correspondent à celles de la NASA à moins d'une seconde d'arc. C'est le degré de rigueur que mérite un rituel quotidien : si le ciel est juste, la lecture qu'on en fait mérite qu'on l'écoute.
Le calcul est un fait ; l'interprétation est un langage. Nous maîtrisons les deux, de bout en bout.
Un serveur MCP : le vrai ciel, pour votre IA
Parce que nous maîtrisons ce moteur de bout en bout, nous l'ouvrons via le Model Context Protocol (MCP) — le standard par lequel les assistants IA (Claude, ChatGPT, agents) appellent des outils externes. Branchez votre agent : il obtient des positions calculées, jamais devinées, directement à la source.
19 outils exposés
Dix-neuf outils, tous adossés au même moteur calculé côté serveur :
Positions & ciel
| Outil | Entrée | Sortie |
|---|---|---|
get_planet_positions | datetime (ISO UTC) | positions écliptiques de tous les corps (signe, degré, rétro) |
get_moon_phase | datetime (ISO UTC) | phase lunaire, illumination %, description |
get_current_sky | latitude, longitude | le ciel maintenant (transits du moment) pour un lieu |
get_aspects | datetime (ISO UTC) | grille d'aspects majeurs et mineurs entre les corps |
Thème natal & relations
| Outil | Entrée | Sortie |
|---|---|---|
get_natal_chart | naissance + zodiac (tropical/sidéral), houseSystem (7 systèmes) | thème complet : maisons, aspects, ASC/MC, phase lunaire, Lots hermétiques |
get_transits | naissance + datetime optionnel | aspects transit→natal, triés par orbe |
get_synastry | deux naissances | aspects inter-thèmes + résumé harmonie/tension |
get_composite_chart | deux naissances | thème composite par mi-points |
get_secondary_progressions | naissance + targetDate | positions progressées (« un jour = un an ») |
get_solar_return | naissance + year (+ lieu optionnel) | instant + thème du retour solaire |
get_lunar_return | naissance + after optionnel | instant + thème du prochain retour lunaire |
Événements célestes
| Outil | Entrée | Sortie |
|---|---|---|
get_ingresses | body, start, end | dates de changement de signe (robuste au rétrograde) |
get_retrograde_windows | body, start, end | stations rétrograde/directe sur la période |
get_eclipse_details | datetime, kind | magnitude, obscuration, Saros d'une éclipse connue |
get_next_eclipse | from, kind, backward optionnel | prochaine/précédente éclipse : maximum, type, contacts |
Astrocartographie, numérologie, autorité
| Outil | Entrée | Sortie |
|---|---|---|
get_astrocartography | datetime (ISO UTC) | lignes planétaires MC/IC + parans (croisements) |
get_life_path | date (YYYY-MM-DD) | nombre du chemin de vie (numérologie) |
get_engine_diagnostic | — | moteur actif, chargement de l'addon natif, précision réelle |
validate_against_horizons | datetime, bodies optionnel | écart vs JPL Horizons (NASA) en secondes d'arc — réseau requis |
Architecture
Le serveur MCP est une façade mince sur notre moteur d'éphémérides : le LLM appelle, le moteur calcule. Selon l'environnement, le calcul est routé vers Swiss Ephemeris (précision de production) ou le moteur maison AstraCore.
Toutes les réponses proviennent du moteur décrit ci-dessus — aligné sur JPL Horizons à moins d'une seconde d'arc. Le modèle met en mots ; il ne calcule jamais.
Connecter à votre IA
Deux façons de brancher le serveur. En local (recommandé) : rien n'est envoyé nulle part, vos données de naissance restent sur votre machine. En hébergé : rien à installer, vous pointez une URL ; le serveur reçoit alors les données de naissance (nous ne les journalisons ni ne les conservons).
Option 1 : en local (npx)
Public et gratuit pour un usage non commercial. Aucun compte, aucune clé. Ajoutez cette entrée à la configuration MCP de votre client (Claude Desktop, Cursor, VS Code, Windsurf, Cline, Zed…) :
{
"mcpServers": {
"llmastro": {
"command": "npx",
"args": ["-y", "@cosmosos/mcp-ephemeris"]
}
}
}En ligne de commande :
# Claude Code
claude mcp add llmastro -- npx -y @cosmosos/mcp-ephemeris
# Codex CLI
codex mcp add llmastro -- npx -y @cosmosos/mcp-ephemerisOption 2 : en hébergé (URL)
Rien à installer, précision maximale (Swiss Ephemeris, sub-arcseconde) côté serveur. Pointez cette URL depuis un client qui gère les serveurs MCP distants (HTTP) : https://mcp.llmastro.com/mcp
{
"mcpServers": {
"llmastro": {
"url": "https://mcp.llmastro.com/mcp"
}
}
}En ligne de commande :
# Claude Code
claude mcp add --transport http llmastro https://mcp.llmastro.com/mcp
# Codex CLI
codex mcp add llmastro --url https://mcp.llmastro.com/mcpSur Claude Desktop : Réglages → Connecteurs → Ajouter un connecteur personnalisé → collez l'URL.
Relancez votre client, puis demandez : « Quelle est la phase de la Lune aujourd'hui ? » La réponse vient de positions réellement calculées. (En local : Node.js 20+ requis.)
Clients compatibles
Claude Code, Claude Desktop, Cursor, Codex CLI, VS Code (Copilot), Windsurf, Cline (et forks Roo Code / Kilo Code), Zed, Continue, Goose, LibreChat, Cherry Studio, ChatGPT, et tout agent compatible MCP.
Code source : github.com/kairosastro-sketch/mcp-ephemeris
Licence
Gratuit pour un usage personnel (personnel, recherche, éducation, associations à but non lucratif), sous licence PolyForm Noncommercial 1.0.0. Usage commercial ou professionnel : licence payante requise — écrivez-nous pour l'obtenir.