Ajouter l'astrologie à votre agent IA via MCP

MCP est un protocole que les modèles IA utilisent pour appeler des outils. Imaginez-le comme une “API REST pour les agents IA” :

• Le serveur expose des outils (calculs, requêtes, actions)
• Le client (Claude Desktop, Cursor, agent personnalisé) les découvre et les appelle
• Le modèle lui-même décide quand utiliser quel outil, en se basant sur la requête de l’utilisateur

Les serveurs MCP peuvent être locaux (exécutés en sous-processus) ou distants (HTTP). La plupart des serveurs locaux sont publiés sur npm et exécutés via npx.

Le serveur MCP AstroWay expose un outil par opération API, 735 dans le package npm et 843 sur le serveur hébergé, avec des noms comme astroway_<groupe>_<opération> :

• astroway_western_chart et les outils voisins pour les cartes, transits, progressions et retours
• astroway_relational_* pour la synastrie, le composite et les cartes de groupe
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry : interprétations IA
• groupes d’astrologie Human Design, védique, chinoise, hellénistique, de tarot et de numérologie

Pour réduire la liste, connectez un serveur de domaine unique au lieu du catalogue complet, voir configuration MCP

Inscrivez-vous sur astroway.info et créez une clé API gratuite (10 000 crédits/mois, sans carte de crédit).

Le fichier claude_desktop_config.json :

• macOS : ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows : %APPDATA%\Claude\claude_desktop_config.json

Ajoutez le serveur astroway :

{
  "mcpServers": {
    "astroway": {
      "command": "npx",
      "args": ["@astroway/mcp"],
      "env": {
        "ASTROWAY_API_KEY": "aw_live_your_key_here"
      }
    }
  }
}

Après le redémarrage, les outils AstroWay apparaîtront dans le menu des outils dans le champ de saisie du chat.

Maintenant, parlez simplement avec Claude dans un langage naturel :

Vous : Créez un thème natal pour une personne née le 14 juillet 1990 à 14:30 à Kiev. Que signifie son Soleil en Cancer dans la 10ème maison ?

Claude : Appelle natal_chart avec les coordonnées analysées, puis interpret_placement. Voici le thème natal. Le Soleil en Cancer dans la 10ème maison indique…

Claude lui-même :

• analyse le langage naturel (ville → coordonnées)
• choisit l’outil approprié
• formate la réponse

Si vous construisez un agent IA personnalisé (pas Claude Desktop), vous pouvez également utiliser le serveur MCP. Le protocole est documenté :

import { spawn } from 'child_process';

const mcp = spawn('npx', ['@astroway/mcp'], {
  env: {
    ...process.env,
    ASTROWAY_API_KEY: process.env.ASTROWAY_API_KEY,
  },
  stdio: ['pipe', 'pipe', 'pipe'],
});

// MCP initialize
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// List the tools
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Call a tool
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 3,
  method: 'tools/call',
  params: {
    name: 'natal_chart',
    arguments: {
      date: '1990-07-14',
      time: '14:30:00',
      timezoneOffset: 3,
      latitude: 50.4501,
      longitude: 30.5234,
    },
  },
}) + '\n');

La plupart des frameworks pour agents (LangChain, LlamaIndex, etc.) ont un support intégré pour MCP.

Si vous ne voulez pas la surcharge de MCP, appelez l’API HTTP directement depuis l’agent :

async function callAstrowayTool(tool: string, input: object) {
  const res = await fetch(`https://api.astroway.info/v1/${tool}`, {
    method: 'POST',
    headers: {
      'X-Api-Key': process.env.ASTROWAY_API_KEY!,
      'Content-Type': 'application/json',
    },
    body: JSON.stringify(input),
  });
  return res.json();
}

// Use in your agent loop
const chart = await callAstrowayTool('chart', birthData);

Avantages de MCP : descriptions d’outils structurées, auto-détection, gestion standardisée des erreurs. Avantages HTTP : plus simple, fonctionne partout, sans sous-processus.

Lorsque MCP est configuré, essayez dans Claude :

1. “Quel est mon horoscope quotidien ? Je suis né le 3 octobre 1993 à 6h du matin à New York”.
2. “Calculez mon type Human Design. Né le 22 avril 1987 à 16:45 à Londres”.
3. “Comparez la compatibilité de deux personnes : moi (14 juillet 1990, Kiev) et mon amie (22 mars 1992, Paris)”.
4. “Quels sont les principaux transits pour moi aujourd’hui ? Donnez une interprétation”.
5. “Je ne connais pas l’heure exacte de naissance. Qu’est-ce que l’analyse de sensibilité montre pour une plage de ±30 minutes ?”

Claude choisira lui-même les outils nécessaires, appellera plusieurs de manière coordonnée en chaîne et formatera la réponse en langage humain.

Les outils d’interprétation IA d’AstroWay (interpret_*, *_horoscope) ont des garde-fous de sécurité intégrés :

• Aucun conseil médical, juridique ou financier
• Avertissements auto-injectés
• Filtrage de contenu

Lorsque l’agent affiche le texte d’interprétation à l’utilisateur - gardez l’avertissement. Il se trouve dans le champ disclaimer de chaque réponse IA.

Les appels MCP passent par le même système de crédits que l’HTTP. Requêtes simples (10 crédits) → carte (20) → synastrie (50) → interprétation IA (50).

Pour un usage personnel (un utilisateur qui pose des questions à Claude) - environ 200-500 crédits par mois. Le tarif gratuit est largement suffisant.

Pour un agent de production avec des centaines d’utilisateurs - calculez en fonction du mélange d’endpoints. Un bot horoscope quotidien pour 1 000 utilisateurs = 1 000 × 20 × 30 = 600 000 crédits/mois → plan Pro.

• AstroWay MCP sur npm
• Agents IA et MCP : cas d’usage : guide d’intégration complet
• API Horoscope & Interprétations IA : page produit
• Démarrage rapide : obtenez une clé API (gratuit, 10 000 crédits/mois)