MCP - connexion Claude / Cursor

Le serveur Model Context Protocol d’AstroWay expose tous les 771 endpoints comme outils pour l’agent IA. Deux modes – tous deux sont nativement pris en charge par tous les clients compatibles MCP.

Mode	URL / commande	Quand choisir
HTTP hébergé	https://mcp.astroway.info/mcp	Claude Web (claude.ai dans le navigateur), Claude Desktop / Cursor / Code newcomers sans npm, ou quand tu veux une installation zéro.
Stdio (npm)	npx @astroway/mcp	Utilisateurs avancés de Cursor, développement local, soucieux de la confidentialité (la clé ne quitte jamais ta machine), prêt pour le hors-ligne.

L’endpoint hébergé et le package npm utilisent le même catalogue d’outils (généré à partir d’un seul /v1/openapi.json). Authentification : la même clé API aw_test_* / aw_live_* – pour l’hébergé, elle est envoyée via l’en-tête Authorization: Bearer …, pour stdio, via la variable d’environnement ASTROWAY_API_KEY.

Source : github.com/astroway/astroway-mcp · npm : npmjs.com/package/@astroway/mcp · hébergé : mcp.astroway.info/health

Hébergé (mcp.astroway.info) - installation zéro

Démarrage rapide sans npm – choisis ton client. Avant l’installation, obtiens une clé sur api.astroway.info/dashboard/sign-up (10 000 crédits/mois gratuits).

Cursor (un clic)

Clique sur le bouton – Cursor s’ouvrira, te demandera de confirmer, et ajoutera l’entrée automatiquement :

Installer dans Cursor →

Étape 2 obligatoire – sinon cela ne fonctionnera pas

Cursor ne peut pas insérer le secret depuis le deeplink – Bearer YOUR_API_KEY sera écrit littéralement dans ~/.cursor/mcp.json, ce à quoi le serveur répondra 403 invalid_format.

Après avoir cliqué sur le bouton :

1. Paramètres de Cursor (⚙️ coin supérieur droit) → Outils & MCP → trouve astroway-hosted dans la liste.
2. Clique sur les trois points (⋯) à côté du serveur → Modifier la configuration.
3. Dans le champ Authorization, remplace Bearer YOUR_API_KEY par Bearer aw_test_… (ou aw_live_…) – ta vraie clé depuis le Tableau de bord.
4. Enregistre → rouvre la liste MCP → assure-toi que le statut est activé + point vert + compteur 780+ outils activés.

Alternativement – modifie le fichier directement : ~/.cursor/mcp.json (headers.Authorization).

Note

Cursor impose une limite sur la longueur des noms : server_name:tool_name ≤ 60 caractères. Environ 90 des 780+ outils (principalement les groupes hellenistic_*, psychological_*, zi_wei_*, zodiac_* et numerology_*) sont filtrés par Cursor et ne seront pas disponibles via le LLM. Les ~690 autres fonctionnent. Claude Desktop n’a pas cette limite – le catalogue complet est disponible.

Claude Desktop

Paramètres → Développeur → Modifier la configuration ouvre claude_desktop_config.json. Ce fichier n’exécute que des commandes locales : une entrée avec seulement un url est ignorée avec le message “Some MCP servers couldn’t be loaded”. Le serveur hébergé se connecte via le pont mcp-remote, il nécessite Node.js :

{
  "mcpServers": {
    "astroway-hosted": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.astroway.info/mcp", "--header", "Authorization:${AUTH_HEADER}"],
      "env": { "AUTH_HEADER": "Bearer aw_live_..." }
    }
  }
}

Ferme complètement Claude Desktop (Cmd+Q) et rouvre-le. La clé se trouve dans env, car Claude Desktop sous Windows coupe l’argument au niveau de l’espace après Bearer.

La boîte de dialogue Ajouter un connecteur personnalisé dans Paramètres → Connecteurs n’accepte que le nom et l’URL ; il n’y a pas de champ pour l’en-tête Authorization, donc la clé AstroWay ne peut pas être transmise par ce biais pour le moment.

Configuration JSON (manuelle)

Pour Cursor, Cline, Continue et Windsurf, qui acceptent directement un url distant :

{
  "mcpServers": {
    "astroway-hosted": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": {
        "Authorization": "Bearer aw_live_..."
      }
    }
  }
}

Chemins vers les configurations :

• Cursor : ~/.cursor/mcp.json (globalement) ou .cursor/mcp.json (dans l’espace de travail)
• Cline (VS Code) : .cline/mcp.json dans l’espace de travail
• Continue : ~/.continue/config.json (bloc mcpServers)
• Windsurf : ~/.codeium/windsurf/mcp_config.json

Après modification, redémarre complètement le client (Cmd+Q → rouvrir).

Vérification

curl https://mcp.astroway.info/health
# {"status":"ok","version":"…","uptime_sec":…,"mcp_protocol_version":"…"}

Dans le client – demande : “List 5 AstroWay tool names from astroway-hosted”. Cela devrait retourner des noms comme astroway_western_chart, astroway_horoscope_daily, astroway_vedic_panchang_full, …

Limites de débit

L’endpoint hébergé est protégé par une limitation à 3 niveaux : couche DDoS Cloudflare + proxy edge 120 req/min/IP + bucket en mémoire 60/60s/(IP+key). Les vrais clients MCP (Claude Desktop, Cursor) ne s’approchent pas de ces limites – ils ne font pas de requêtes en rafale. Si ton automatisation / CI nécessite > 120 req/min – utilise le mode stdio (il n’y a pas de limites, il passe directement par api.astroway.info/v1/* avec ta limite de débit tarifaire).

Que faire si mcp.astroway.info est temporairement indisponible

Si l’endpoint hébergé retourne un 5xx, le client MCP verra une erreur lors de tools/list. Cela n’affecte pas les clients stdio – ils lancent un package npm local qui accède directement à api.astroway.info/v1/* sans couche hébergée intermédiaire.

Fallback pour les intégrations critiques : ajoute un deuxième serveur MCP dans la configuration avec le mode stdio – le client l’utilisera automatiquement si l’hébergé ne répond pas à tools/list :

{
  "mcpServers": {
    "astroway": {
      "url": "https://mcp.astroway.info/mcp",
      "headers": { "Authorization": "Bearer aw_live_..." }
    },
    "astroway-fallback": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

La disponibilité réelle de l’endpoint hébergé est visible sur status.astroway.info. Les incidents > 5 minutes sont publiés comme postmortem dans les 5 jours ouvrables (selon /sla/).

Stdio (npm) - pour le développement local

@astroway/mcp – un package npm qui s’exécute localement en tant que sous-processus. Un seul package npm, intégration native avec Claude Desktop, Cursor et tout client compatible MCP.

Comment ça marche

La liste des outils est générée au moment de la compilation à partir de la spécification OpenAPI en direct (api.astroway.info/v1/openapi.json). Chaque version du package intègre automatiquement tous les nouveaux endpoints – aucune maintenance manuelle n’est requise.

Chaque endpoint devient un outil de type :

• tools/list retourne la description et le schéma d’entrée (avec un exemple de corps de requête)
• tools/call effectue une requête HTTP POST vers https://api.astroway.info/v1/<path> avec ta ASTROWAY_API_KEY
• La réponse est retournée à l’agent sous forme de JSON structuré

Chaque version est également livrée avec la provenance SLSA (attestée par Sigstore) – c’est une garantie que le package npm a été construit à partir du commit dans le dépôt public.

Installation

Claude Desktop (macOS)

Ajoute à ~/Library/Application Support/Claude/claude_desktop_config.json :

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_..."
      }
    }
  }
}

Redémarre Claude Desktop. Dans la barre sous le chat, un indicateur 🛠️ apparaîtra avec le nombre d’outils chargés.

Cursor

Ajoute à ~/.cursor/mcp.json :

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Cline / Continue / Windsurf / Copilot / VS Code MCP

La même commande npx @astroway/mcp fonctionne dans chaque client compatible MCP. La configuration est identique – seul le chemin du fichier change :

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["-y", "@astroway/mcp"],
      "env": { "ASTROWAY_API_KEY": "aw_live_..." }
    }
  }
}

Client	Chemin vers la configuration
Cline (VS Code)	.cline/mcp.json à la racine de l’espace de travail
Continue	~/.continue/config.json (sous mcpServers)
Windsurf	~/.codeium/windsurf/mcp_config.json
GitHub Copilot Chat (VS Code)	drapeau de prévisualisation → mcp.json dans l’espace de travail
Extension VS Code MCP	~/.vscode/mcp.json

Autres clients MCP

Lance comme serveur stdio :

ASTROWAY_API_KEY=aw_live_... npx @astroway/mcp

Astuce

Obtiens une clé sur api.astroway.info/dashboard/sign-up. Niveau gratuit – 10 000 crédits/mois, sans carte.

Confidentialité - depuis v1.0.0+

Ce serveur MCP n’envoie rien en retour à AstroWay à l’exception des appels API que tu lui demandes d’exécuter. Aucune télémétrie, aucune analyse, aucun interrupteur d’opt-in/opt-out – silence par défaut.

Les requêtes sortantes portent deux en-têtes d’identification afin que le backend AstroWay puisse distinguer le trafic MCP du trafic HTTP direct dans ses propres logs :

• User-Agent: astroway-mcp/<version> (Node/<node-version>)
• X-Astroway-Channel: mcp

Aucun d’eux ne contient d’ID de session, d’empreinte de machine ou quoi que ce soit de personnel. C’est la sémantique standard de User-Agent – chaque outil CLI envoie des informations similaires.

Enregistrement de sous-ensembles - depuis v1.0.0+

Si tu n’utilises qu’une partie du catalogue – enregistre un sous-ensemble pour que la fenêtre contextuelle du LLM reste compacte :

{
  "env": {
    "ASTROWAY_API_KEY": "aw_live_...",
    "ASTROWAY_TOOL_GROUPS": "western,vedic,relational",   // only these prefixes
    "ASTROWAY_READONLY": "1"                               // skip ai/horoscope/reports (LLM-backed, costs credits)
  }
}

Groupes courants : western, vedic, tarot, numerology, hd (Human Design), relational (synastry/composite/davison), prognostics (transits/progressions/returns), aspects, horary, geo, chinese, bazi, mayan, iching, runes, geomancy. Exécute npx @astroway/mcp --list-tools pour voir l’ensemble complet.

ASTROWAY_READONLY=1 ignore trois groupes qui appellent en interne le LLM (ai, horoscope, reports) – utile quand tu veux des calculs de cartes purement déterministes sans dépenser de crédits pour la génération de texte.

Engagement de stabilité - depuis v1.0.0+

• Le catalogue est gelé pour la durée de la session. 780+ outils, 12 prompts, 14 ressources sont intégrés dans le package npm publié au moment de la compilation – rien ne change pendant la connexion. Si ton client met en cache tools/list après le premier appel – il reste correct pour toute la session.
• Les identifiants d’outils sont stables au sein d’une version majeure. Le nom sous astroway_<group>_<tool> ne sera pas renommé ou supprimé au sein de v1.x sans une note de dépréciation dans CHANGELOG.md et une disponibilité parallèle d’une version mineure.
• La forme d’entrée des outils est stable au sein d’une version mineure. Les contraintes (regex, range, enum) sont ajoutées dans les patchs ; l’ajout d’un champ obligatoire nécessite une mise à jour mineure.
• Actualisation du catalogue : par réinstallation. npm i -g @astroway/mcp@latest (ou la forme npx -y @astroway/mcp dans ta configuration) récupère l’ensemble actuel au prochain démarrage.

Exemples de prompts

Après avoir connecté le serveur, demande à l’IA :

Thème natal

Calcule mon thème natal – né le 15 mars 1990, 14:30, Kiev. Décris le Soleil, la Lune, l’Ascendant et trouve les aspects serrés.

Claude appellera l’outil chart avec tes paramètres, recevra un JSON structuré, et décrira le thème en mots.

Transits

Quels transits significatifs des planètes lentes affecteront mon thème natal au cours de l’année 2027 ?

Claude effectuera deux appels d’outils : d’abord transits (instantané actuel), puis transit-calendar (plage). Il interprétera les tendances.

Mahadasha védique

Lance la Mahadasha Vimshottari pour une personne née le 22.07.1985 à 06:45 à Mumbai. Dans quelle période se trouve cette personne actuellement ?

Via l’outil vedic/dashas/vimshottari/maha – le timestamp UTC exact de la période actuelle.

Synastrie

Compare deux thèmes : A - 10.06.1988 09:15 Londres, B - 22.11.1991 22:40 Berlin. Quels sont les aspects croisés les plus forts ?

L’outil synastry avec deux blocs chart + interprétation du score de compatibilité.

Tarot

Tire 3 cartes Rider-Waite-Smith : Passé - Présent - Futur. Question : “devrais-je accepter ce nouveau travail ?”. Seed = 42.

tarot/rider-waite/spread avec un seed fixe pour la reproductibilité.

Liste de tous les outils

Après la connexion, demande à Claude :

Énumère tous les outils astroway.

Ou depuis la ligne de commande :

ASTROWAY_API_KEY=aw_test_smoke npx @astroway/mcp 2>&1 | head -1
# (starts the stdio server; tool-list calls come from the MCP client over the protocol)

Configuration

Variable	Par défaut	Description	Depuis la version
ASTROWAY_API_KEY	(obligatoire)	Live : aw_live_.... Sandbox : aw_test_....	0.1.0
ASTROWAY_BASE_URL	https://api.astroway.info/v1	Surcharge pour les environnements auto-hébergés/de staging.	0.1.0
ASTROWAY_TOOL_GROUPS	(tous les groupes)	Préfixes séparés par des virgules pour limiter le catalogue (western,vedic,relational).	1.0.0
ASTROWAY_READONLY	0	1 ignore les groupes basés sur le LLM (ai, horoscope, reports).	1.0.0
LOG_LEVEL	error	silent/error/warn/info/debug – niveau de journalisation sur stderr.	0.8.0
LOG_FILE	(non écrit)	Chemin du fichier pour dupliquer les logs.	0.8.0
MCP_FLAT_TOOLS	0	1 retourne les noms plats d’avant v0.9 (chart au lieu de astroway_western_chart). Hérité.	0.9.0

Pourquoi MCP et non une intégration directe

Un LLM générique (sans ancrage) dira “quelque part en juillet, Saturne formera un trigone à ton Jupiter” – sans date précise, avec un décalage de ±15 jours. L’agent MCP effectue un tool_use POST /v1/transits et retourne un timestamp UTC à la seconde près, basé sur le véritable Swiss Ephemeris.

L’avantage n’est pas dans le LLM, mais dans la garantie que les calculs sont réels – non inventés.

Distribution du package

• Liste mcp.so : mcp.so/server/astroway-mcp/astroway
• mcpservers.org : en attente d’approbation (en mai 2026)
• awesome-mcp-servers (punkpeye) : PR #5972

Liens

• 📦 npm : npmjs.com/package/@astroway/mcp
• 📘 Documentation API : /docs/api/
• 🔑 Inscription : /dashboard/sign-up
• 💰 Tarification : /pricing/
• 🌐 Dépôt public (MIT) : github.com/astroway/astroway-mcp