Adjon hozzá asztrológiát az AI-ügynökéhez az MCP-n keresztül

Ha dolgoztál a MCP-vel (Model Context Protocol) az elmúlt évben? Valószínűleg találkoztál vele. Ez egy nyílt standard, amit az Anthropic hozott létre, hogy külső eszközöket csatlakoztassunk az AI-modellekhez. Pár sor konfiguráció, és a Claude már képes lesz a fájlrendszerhez, adatbázishoz vagy bármely REST API-hoz hozzáférni.

Ebben a bejegyzésben megmutatom, hogyan integrálhatsz asztrológiai számításokat egy AI-ágensbe az MCP segítségével. Kevesebb mint 5 perc alatt meglesz.

Az MCP egy protokoll, amit az AI-modellek használnak eszközök meghívásához. Képzeld el úgy, mint egy „REST API az AI-ágenseknek”:

• A szerver kihelyezi az eszközöket (számítások, lekérdezések, műveletek)
• A kliens (Claude Desktop, Cursor, egyedi ágens) felfedezi és meghívja őket
• A modell magától eldönti, hogy mikor melyik eszközt alkalmazza — a felhasználó kérésének alapján

Az MCP-szerverek lehetnek helyi (olyan folyamatként futnak, mint egy alprocess) vagy távoli (HTTP). A legtöbb helyi, és az npm-en keresztül kerül publikálásra, majd npx-szel indítható.

Az AstroWay MCP-szerver 25 eszközt tesz elérhetővé, amelyek lefedik a főbb asztrológiai számításokat:

• natal_chart — teljes nativitási diagram
• synastry — két ember összeillősége
• transits — aktuális tranzitok a nativitási diagramon
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — AI-alapú interpretációk
• human_design — teljes HD-diagram
• hd_incarnation_cross, hd_compatibility — HD-specifikus funkciók
• plusz még 12, amelyek lefedik a progressziókat, solar returns-öket, asztrokartográfiát, rectificációt

Regisztrálj az astroway.info oldalon, és hozz létre egy ingyenes API-kulcsot (10 000 credit/hónap, kártya nélkül).

A claude_desktop_config.json fájl:

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

Add hozzá az astroway-szervert:

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

Az újraindítás után láthatod a kalapács ikont a 25 elérhető eszközzel.

Mostantól egyszerűen beszélhetsz a Claudéval természetes nyelven:

Te: Készíts egy nativitási diagramot annak a személynek, aki 1990. július 14-én született 14:30-kor Kijevben. Mit jelent a Nap Rákban a 10. házban?

Claude: Meghívja a natal_chart eszközt a feldolgozott koordinátákkal, majd az interpret_placement eszközt. Itt a nativitási diagram. A Nap Rákban a 10. házban azt jelenti, hogy…

A Claude magától:

• feldolgozza a természetes nyelvet (város → koordináták)
• kiválasztja a megfelelő eszközt
• formázza a választ

Ha egyedi AI-ágenset építesz (nem a Claude Desktopot), az MCP-szervert szintén használhatod. A protokoll dokumentált:

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 inicializálás
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 1,
  method: 'initialize',
  params: { protocolVersion: '2024-11-05', capabilities: {} },
}) + '\n');

// Eszközök listája
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Eszköz meghívása
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');

A legtöbb ágens-framework (LangChain, LlamaIndex stb.) rendelkezik beépített MCP-támogatással.

Ha nem akarsz MCP-fölösleget, hívhatod az HTTP-API-t közvetlenül az ágensből:

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

// Használat az ágens ciklusában
const chart = await callAstrowayTool('chart', birthData);

MCP előnyei: strukturált eszközleírások, automatikus detektálás, szabványos hibakezelés. HTTP előnyei: egyszerűbb, bárhol működik, nincs szükség alprocesszekre.

Amikor az MCP be van állítva, próbáld ki a Claudéban:

1. „Mi a mai napi horoszkópom? 1993. október 3-án születettem 6 órakor New Yorkban.”
2. „Számítsd ki a Human Design típusomat! 1987. április 22-én születettem 16:45-kor Londonban.”
3. „Hasonlítsd össze két ember összeillőségét: én (1990. július 14., Kijev) és a barátnőm (1992. március 22., Párizs).”
4. „Mik a főbb tranzitjaim ma? Add meg az interpretációt!”
5. „Nem ismerem a pontos születési időmet. Mit mutat a sensitivity-elemzés ±30 perces tartományban?”

A Claude magától kiválasztja a szükséges eszközöket, összehangoltan meghívja a láncolatot, és emberi nyelven formázza a választ.

Az AstroWay AI-alapú interpretációs eszközei (interpret_*, *_horoscope) beépített védelmi rendszerekkel rendelkeznek:

• Semmilyen orvosi, jogi vagy pénzügyi tanács
• Automatikusan beszúrt disclaimer-ek
• Tartalomszűrés

Amikor az ágens megjeleníti a felhasználónak az interpretációs szöveget, tartsd meg a disclaimer-t. Ez a disclaimer mezőben található minden AI-válaszban.

Az MCP-hívások ugyanazon a credit-rendszeren keresztül mennek, mint az HTTP. Egyszerű lekérdezések (10 credit) → diagram (20) → összeillőség (50) → AI-interpretáció (50).

Személyes használat esetén (egy felhasználó, aki kérdéseket tesz fel a Claudénak) körülbelül 200–500 credit havonta. Az ingyenes tarifával bőven elég.

Termelési ágens esetén több száz felhasználóval számolj a kevert endpointok függvényében. Egy napi horoszkóp-bot 1 000 felhasználóval = 1 000 × 20 × 30 = 600 000 credit/hó → Pro terv.

• AstroWay MCP az npm-en
• AI-ágensek és MCP — use case — teljes integrációs útmutató
• Horoszkóp & AI Interpretations API — termékoldal
• Gyors kezdés — kapj API-kulcsot (ingyenesen, 10 000 credit/hó)