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

Як dacă ai lucrat cu Claude Desktop în ultimul an, probabil ai văzut MCP (Model Context Protocol). Este un standard deschis de la Anthropic pentru conectarea instrumentelor externe la modelele AI. Câteva linii de config - și Claude poate accesa sistemul de fișiere, baza de date sau orice API.

În acest post - cum să adaugi calcule astrologice la un agent AI prin MCP. Timp: mai puțin de 5 minute.

MCP - protocolul prin care modelele AI apelează instrumente. Imaginează-l ca un “REST API pentru agenți AI”:

• Server expune instrumente (calcule, interogări, acțiuni)
• Client (Claude Desktop, Cursor, agent personalizat) le descoperă și le apelează
• Modelul decide singur când să folosească fiecare instrument: pe baza cererii utilizatorului

Serverele MCP pot fi locale (rulate ca subproces) sau remote (HTTP). Majoritatea locale - publicate pe npm și pornite prin npx.

Serverul MCP AstroWay expune un instrument pentru fiecare operație API, 735 în pachetul npm și 843 pe serverul găzduit, cu denumiri de forma astroway_<grup>_<operație>:

• astroway_western_chart și instrumentele înrudite pentru hărți, tranzite, progresii și reveniri
• astroway_relational_* pentru sinastrie, compozit și hărți de grup
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretări AI
• grupuri Human Design, vedică, chineză, elenistică, tarot și numerologie

Pentru a scurta lista, conectează un singur server de domeniu în locul catalogului complet, vezi configurarea MCP

Înregistrează-te pe astroway.info și creează o cheie API gratuită (10 000 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ă repornire, instrumentele AstroWay vor apărea în meniul de instrumente din câmpul de introducere a chatului.

Acum vorbește pur și simplu cu Claude în limbaj natural:

Tu: Construiește harta natală a unei persoane născute pe 14 iulie 1990 la 14:30 în Kiev. Ce înseamnă Soarele ei în Rac în casa a 10‑a?

Claude: Apelează natal_chart cu coordonate parsate, apoi interpret_placement. Iată harta natală. Soarele în Rac în casa a 10‑a indică…

Claude face singur:

• parsează limbajul natural (oraș → coordonate)
• alege instrumentul potrivit
• formatează răspunsul

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

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

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

Dacă nu vrei costuri suplimentare MCP - apelează HTTP-API 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();
}

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

Pro MCP: descrieri structurate ale instrumentelor, autodetectare, gestionare standardizată a erorilor. Pro HTTP: mai simplu, funcționează oriunde, fără subprocese.

Când 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. Născut pe 22 aprilie 1987 la 16:45 în Londra.”
3. “Compară compatibilitatea a două persoane: eu (14 iulie 1990, Kiev) și prietena (22 martie 1992, Paris).”
4. “Care sunt tranzitele principale pentru mine astăzi? Dă o interpretare.”
5. “Nu știu ora exactă a nașterii. Ce arată analiza de sensibilitate pentru intervalul ±30 minute?”

Claude va alege singur instrumentele necesare, le va apela în lanț și va formata răspunsul în limbaj uman.

Instrumentele de interpretare AI AstroWay (interpret_*, *_horoscope) au protecții de siguranță încorporate:

• Nicio consiliere medicală, juridică sau financiară
• Disclaimer‑uri injectate automat
• Filtrare de conținut

Când agentul afișează textul de interpretare utilizatorului - păstrează disclaimer‑ul. Este în câmpul disclaimer al fiecărui răspuns AI.

Apelurile MCP trec prin același sistem de credite ca și HTTP. Probe simple (10 credite) → chart (20) → sinastrie (50) → interpretare AI (50).

Pentru utilizare personală (un singur utilizator care pune întrebări lui Claude) - cam 200–500 credite pe lună. Plan gratuit cu mult spațiu.

Pentru un agent de producție cu sute de utilizatori - calculează în funcție de mixul de endpointuri. Botul Daily-horoscope pentru 1 000 de utilizatori = 1 000 × 20 × 30 = 600 000 credite/lună → plan Pro.

• AstroWay MCP în npm
• AI‑agenți și MCP: use case: ghid complet de integrare
• Horoscope & AI Interpretations API: pagină de produs
• Start rapid: obține cheia API (gratuit, 10 000 credite/lună)