Aggiungi astrologia al tuo agente AI tramite MCP

Se hai lavorato con Claude Desktop nell’ultimo anno, hai probabilmente visto il MCP (Model Context Protocol). Si tratta di uno standard aperto di Anthropic per collegare strumenti esterni ai modelli di intelligenza artificiale. Basta aggiungere alcune righe di configurazione e Claude potrà accedere al file system, al database o a qualsiasi API.

In questo post, ti mostrerò come aggiungere calcoli astrologici all’agente di intelligenza artificiale tramite MCP. Ci vorranno meno di 5 minuti.

MCP è un protocollo che consente ai modelli di intelligenza artificiale di richiamare strumenti. Immagina un “REST API per agenti di intelligenza artificiale”:

• Server espone gli strumenti (calcoli, richieste, azioni)
• Client (Claude Desktop, Cursor, agente personalizzato) li rileva e li richiama
• Il modello decide quando utilizzare quale strumento in base alla richiesta dell’utente

I server MCP possono essere locali (avviati come sottoprocesso) o remoti (HTTP). La maggior parte dei server locali sono pubblicati su npm e possono essere avviati tramite npx.

Il server MCP AstroWay espone 25 strumenti che coprono i principali calcoli astrologici:

• natal_chart — carta natale completa
• synastry — compatibilità tra due persone
• transits — transiti attuali sulla carta natale
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — interpretazioni di intelligenza artificiale
• human_design — carta di Human Design completa
• hd_incarnation_cross, hd_compatibility — funzionalità di Human Design
• altri 12 strumenti che coprono progressioni, ritorni solari, astrocartografia, rettificazione

Registra un account su astroway.info e crea una chiave API gratuita (10.000 crediti/mese, senza carta di credito).

File claude_desktop_config.json:

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

Aggiungi il server AstroWay:

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

Dopo il riavvio, vedrai l’icona del martello con 25 strumenti disponibili.

Ora puoi semplicemente parlare con Claude in linguaggio naturale:

Tu: Crea la carta natale di una persona nata il 14 luglio 1990 alle 14:30 a Kiev. Cosa significa il suo Sole in Cancro nella 10ª casa?

Claude: Richiama natal_chart con coordinate parsate, poi interpret_placement. Ecco la carta natale. Il Sole in Cancro nella 10ª casa indica…

Claude stesso:

• analizza il linguaggio naturale (città → coordinate)
• sceglie lo strumento giusto
• formatta la risposta

Se stai creando un agente di intelligenza artificiale personalizzato (non Claude Desktop), il server MCP può essere utilizzato anche in questo caso. Il protocollo è documentato:

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');

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

// Richiamo di uno strumento
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 maggior parte dei framework per agenti (LangChain, LlamaIndex, ecc.) hanno una supporto integrato per MCP.

Se non vuoi utilizzare MCP, puoi chiamare direttamente l’API HTTP dal tuo agente:

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();
}

// Utilizzo nell'agente
const chart = await callAstrowayTool('chart', birthData);

Vantaggi di MCP: descrizioni strutturate degli strumenti, rilevamento automatico, gestione degli errori standardizzata. Vantaggi di HTTP: più semplice, funziona ovunque, senza sottoprocessi.

Quando MCP è configurato, prova a chiedere a Claude:

1. «Qual è il mio oroscopo quotidiano? Sono nato il 3 ottobre 1993 alle 6 del mattino a New York».
2. «Calcola il mio tipo di Human Design. Sono nato il 22 aprile 1987 alle 16:45 a Londra».
3. «Confronta la compatibilità di due persone: io (14 luglio 1990, Kiev) e la mia amica (22 marzo 1992, Parigi)».
4. «Quali sono i transiti principali per me oggi? Dammi un’interpretazione».
5. «Non so l’ora esatta della mia nascita. Cosa mostra l’analisi di sensibilità per un intervallo di ±30 minuti?»

Claude stesso sceglierà gli strumenti giusti, li richiamerà in sequenza e formatterà la risposta in linguaggio umano.

Gli strumenti di interpretazione di AstroWay (interpret_*, *_horoscope) hanno delle garanzie di sicurezza integrate:

• Nessun consiglio medico, legale o finanziario
• Disclaimer automatici
• Filtraggio del contenuto

Quando l’agente mostra il testo di interpretazione all’utente, conserva il disclaimer. È presente nel campo disclaimer di ogni risposta di intelligenza artificiale.

Le chiamate MCP utilizzano lo stesso sistema di crediti dell’API HTTP. Campioni semplici (10 crediti) → carta natale (20) → sinastria (50) → interpretazione di intelligenza artificiale (50).

Per l’uso personale (un utente che pone domande a Claude) — circa 200-500 crediti al mese. Il piano gratuito è sufficiente.

Per un agente di produzione con centinaia di utenti — calcola in base alla miscela di endpoint. Un bot di oroscopi quotidiani per 1.000 utenti = 1.000 × 20 × 30 = 600.000 crediti/mese → piano Pro.

• AstroWay MCP su npm
• Agenti di intelligenza artificiale e MCP — use case — guida di integrazione completa
• API di oroscopi e interpretazioni di intelligenza artificiale — pagina del prodotto
• Guida rapida — ottieni la chiave API (gratuita, 10.000 crediti/mese)