Ajouter l'astrologie à votre agent IA via MCP

Si vous avez travaillé avec Claude Desktop au cours de la dernière année, vous avez probablement vu le MCP (Model Context Protocol). Il s’agit d’un standard ouvert d’Anthropic pour connecter des outils externes aux modèles d’IA. Quelques lignes de configuration et Claude peut accéder au système de fichiers, à la base de données ou à n’importe quelle API.

Dans cet article, nous allons voir comment ajouter des calculs astrologiques à un agent IA via le MCP. Cela prend moins de 5 minutes.

Le MCP est un protocole qui permet aux modèles d’IA d’appeler des outils. Imaginez-le comme un « REST API 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 décide lui-même quand utiliser quel outil - en fonction de la demande de l’utilisateur

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

Le serveur MCP AstroWay expose 25 outils qui couvrent les calculs astrologiques de base :

• natal_chart - carte natale complète
• synastry - compatibilité entre deux personnes
• transits - transits actuels sur la carte natale
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits - interprétations IA
• human_design - carte HD complète
• hd_incarnation_cross, hd_compatibility - fonctionnalités HD
• 12 autres qui couvrent les progressions, les retours solaires, l’astrocartographie, la rectification

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

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, vous verrez l’icône d’un marteau avec 25 outils disponibles.

Maintenant, parlez simplement à Claude dans un langage naturel :

Vous : Créez une carte natale pour une personne née le 14 juillet 1990 à 14h30 à Kiev. Qu’est-ce que signifie son Soleil en Cancer dans la 10e maison ?

Claude : Appelle natal_chart avec les coordonnées analysées, puis interpret_placement. Voici la carte natale. Le Soleil en Cancer dans la 10e maison indique…

Claude lui-même :

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

Si vous créez un agent IA personnalisé (pas Claude Desktop), le serveur MCP peut également être utilisé. 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');

// Список інструментів
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Виклик інструмента
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 les agents (LangChain, LlamaIndex, etc.) ont une prise en charge intégrée du MCP.

Si vous ne voulez pas les coûts supplémentaires du MCP - appelez l’API HTTP directement à partir de 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();
}

// Використання в циклі агента
const chart = await callAstrowayTool('chart', birthData);

Les avantages du MCP : descriptions structurées des outils, autodétection, traitement standardisé des erreurs. Les avantages de l’API HTTP : plus simple, fonctionne partout, sans sous-processus.

Lorsque le MCP est configuré, essayez dans Claude :

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

Claude choisit lui-même les outils nécessaires, les appelle en chaîne et formate la réponse dans un 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
• Disclaimer auto-inséré
• Filtre de contenu

Lorsque l’agent affiche le texte de l’interprétation à l’utilisateur - conservez le disclaimer. Il est dans le champ disclaimer de chaque réponse IA.

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

Pour une utilisation personnelle (un utilisateur qui pose des questions à Claude) - environ 200-500 crédits par mois. Le tarif gratuit suffit.

Pour un agent de production avec des centaines d’utilisateurs - calculez en fonction du mélange d’endpoints. Bot d’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 - use case - guide d’intégration complet
• API d’horoscope et d’interprétations IA - page de produit
• Démarrage rapide - obtenez une clé API (gratuite, 10 000 crédits/mois)