Adăugați astrologia la agentul dvs. AI prin MCP

Dacă ai lucrat cu MCP (Model Context Protocol) în ultimul an cu Claude Desktop, probabil știi deja despre ce este vorba. Este un standard deschis dezvoltat de Anthropic pentru conectarea instrumentelor externe la modelele AI. Cu câteva linii de configurare, Claude poate accesa sistemul de fișiere, baze de date sau orice API.

În acest ghid, îți arăt cum să adaugi calcule astrologice în agentul tău AI folosind MCP. Totul poate fi făcut în mai puțin de 5 minute.

MCP este un protocol prin care modelele AI apelează instrumente. Gândește-te la el ca la un „REST API pentru agenți AI”:

• Serverul expune instrumente (calcule, interogări, acțiuni)
• Clientul (Claude Desktop, Cursor, un agent personalizat) le detectează și le apelează
• Modelul decide singur când și care instrument să folosească, bazându-se pe cererea utilizatorului

Serverele MCP pot fi locale (lansate ca subprocese) sau la distanță (HTTP). Majoritatea sunt locale și sunt publicate pe npm, rulând prin npx.

Serverul MCP AstroWay expune 25 de instrumente care acoperă principalele calcule astrologice:

• natal_chart — harta natală completă
• synastry — compatibilitatea dintre două persoane
• transits — tranziturile curente asupra hărții natale
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — interpretări AI
• human_design — harta completă Human Design
• hd_incarnation_cross, hd_compatibility — funcții Human Design
• încă 12 care acoperă progresii, solar returns, astrocartografie, rectificare

Înregistrează-te pe astroway.info și creează o cheie API gratuită (10.000 de credite/lună, fără card).

Fișierul claude_desktop_config.json:

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

Adaugă serverul AstroWay:

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

După restart, vei vedea un iconiță de ciocan cu cele 25 de instrumente disponibile.

Acum poți vorbi cu Claude în limbaj natural:

Tu: Construiește-mi harta natală pentru o persoană născută pe 14 iulie 1990 la ora 14:30 în Kiev. Ce înseamnă Soarele în Rac în casa a X-a?

Claude: Apelează natal_chart cu coordonatele parse, apoi interpret_placement. Iată harta natală. Soarele în Rac în casa a X-a indică…

Claude face automat:

• parsarea limbajului natural (oraș → coordonate)
• alegerea instrumentului potrivit
• formatarea răspunsului

Dacă construiești un agent AI personalizat (nu Claude Desktop), poți folosi și serverul MCP. Protocolul este documentat:

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'],
});

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

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

// Apelarea unui instrument
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');

Majoritatea framework-urilor pentru agenți (LangChain, LlamaIndex etc.) au suport încorporat pentru MCP.

Dacă nu vrei overhead-ul MCP, poți apela API-ul HTTP direct din 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();
}

// Utilizare în bucla agentului
const chart = await callAstrowayTool('chart', birthData);

Avantaje MCP: descrieri structurate ale instrumentelor, detectare automată, tratare standardizată a erorilor. Avantaje HTTP: mai simplu, funcționează oriunde, fără subprocese.

Odată ce MCP este configurat, încearcă în Claude:

1. „Care este horoscopul meu zilnic? M-am născut pe 3 octombrie 1993 la 6 dimineața în New York.”
2. „Calculează-mi tipul Human Design. M-am născut pe 22 aprilie 1987 la 16:45 în Londra.”
3. „Compară compatibilitatea dintre două persoane: eu (14 iulie 1990, Kiev) și prietena mea (22 martie 1992, Paris).”
4. „Care sunt principalele mele tranzituri astrologice astăzi? Dă-mi și o interpretare.”
5. „Nu știu ora exactă a nașterii. Ce arată analiza de sensibilitate pentru un interval de ±30 de minute?”

Claude va alege singur instrumentele necesare, va apela mai multe în lanț și va formata răspunsul într-un limbaj natural.

Instrumentele de interpretare AI ale AstroWay (interpret_*, *_horoscope) au mecanisme integrate de siguranță:

• Nicio recomandare medicală, juridică sau financiară
• Disclaimer-uri injectate automat
• Filtrare a conținutului

Când agentul afișează textul interpretării utilizatorului, păstrează disclaimer-ul. Acesta se află în câmpul disclaimer al fiecărei răspunsuri AI.

Apelurile MCP folosesc același sistem de credite ca și HTTP. Interogări simple (10 credite) → hartă (20) → sinastrie (50) → interpretare AI (50).

Pentru utilizare personală (un singur utilizator care pune întrebări lui Claude) — aproximativ 200–500 de credite pe lună. Planul gratuit oferă suficient.

Pentru un agent în producție cu sute de utilizatori — calculează în funcție de mixul de endpoint-uri. Un bot de horoscop zilnic pentru 1.000 de utilizatori = 1.000 × 20 × 30 = 600.000 de credite/lună → planul Pro.

• AstroWay MCP pe npm
• AI agenți și MCP — ghid de integrare — ghid complet de integrare
• API Horoscop & Interpretări AI — pagina produsului
• Start rapid — obține cheia API (gratuit, 10.000 de credite/lună)