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

Ha az elmúlt évben dolgoztál a Claude Desktop‑dal, valószínűleg láttad a MCP‑t (Model Context Protocol). Ez az Anthropic nyílt szabványa külső eszközök AI‑modellekhez csatlakoztatásához. Néhány konfigurációs sor, és a Claude már képes fájlrendszerhez, adatbázishoz vagy bármilyen API‑hoz fordulni.

Ebben a bejegyzésben arról lesz szó, hogyan lehet asztrológiai számításokat hozzáadni egy AI‑ügynökhöz az MCP‑n keresztül. Idő: kevesebb, mint 5 perc.

MCP – egy protokoll, amellyel az AI‑modellek eszközöket hívnak meg. Képzeld el, mint egy “REST API‑t AI‑ügynököknek”:

• Szerver teszi közzé az eszközöket (számítások, lekérdezések, műveletek)
• Kliens (Claude Desktop, Cursor, egyedi ügynök) felfedezi és meghívja őket
• A modell maga dönt arról, mikor melyik eszközt alkalmazza: a felhasználó kérésének alapján

Az MCP‑szerverek lehetnek helyi (alkalmazás alfolyamatként) vagy távoli (HTTP). A legtöbb helyi szervert npm‑ben publikálják, és npx‑szel indítják.

AstroWay MCP‑szerver egy eszközt tesz közzé minden egyes API‑művelethez, az npm‑csomagban 735 darabot, a hosztolt szerveren 843 darabot, a neveik formátuma astroway_<csoport>_<művelet>:

• astroway_western_chart és a szomszédos eszközök térképekhez, tranzitokhoz, progressziókhoz és visszatérésekhez
• astroway_relational_* szinátriához, kompozitokhoz és csoportos térképekhez
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI‑értelmezések
• Human Design, védikus, kínai, hellenisztikus asztrológia, tarot és numerológia csoportok

A lista lerövidítéséhez csatlakoztass egy domain‑szervert a teljes katalógus helyett, lásd a MCP beállítások oldalt.

Regisztrálj a astroway.info oldalon, és hozz létre egy ingyenes API‑kulcsot (10 000 kredit/hó, 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 az AstroWay eszközök megjelennek az eszközmenüben a chat beviteli mezőben.

Most már egyszerűen beszélj Claude‑dal természetes nyelven:

Te: Készíts születési képletet egy személynek, aki 1990. július 14‑én 14:30‑kor született Kijevben. Mit jelent a Napja a Rákban a 10. házban?

Claude: Meghívja a natal_chart‑et a feldolgozott koordinátákkal, majd a interpret_placement‑et. Itt a születési képlet. A Nap a Rákban a 10. házban azt jelzi…

Claude maga:

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

Ha saját egyedi AI‑ügynököt építesz (nem Claude Desktop), az MCP‑szervert is 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 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');

A legtöbb ügynök‑keretrendszer (LangChain, LlamaIndex stb.) beépített MCP‑támogatással rendelkezik.

Ha nem akarsz MCP‑felülviteli költségeket, hívd közvetlenül a HTTP‑API‑t az ügynökbő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();
}

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

MCP előnyei: strukturált eszkökleírások, automatikus felismerés, szabványos hibakezelés. HTTP előnyei: egyszerűbb, bárhol működik, alfolyamatok nélkül.

Ha az MCP be van állítva, próbáld Claude‑nál:

1. Mi a napi horoszkópom? 1993. október 3‑án 6 óra reggel születtem New Yorkban.
2. Számold ki az én Human Design típusomat. 1987. április 22‑én 16:45‑kor születtem Londonban.
3. Hasonlítsd össze két ember kompatibilitását: én (1990. július 14, Kijev) és a barátnőm (1992. március 22, Párizs).
4. Melyek a fő tranzitjaim ma? Adj értelmezést.
5. Nem ismerem a pontos születési időt. Mit mutat a sensitivity‑analízis ±30 perc tartományra?

Claude maga kiválasztja a szükséges eszközöket, sorban meghívja őket, és emberi nyelven formázza a választ.

Az AstroWay AI‑értelmező eszközei (interpret_*, *_horoscope) beépített safety‑guardrail‑ekkel rendelkeznek:

• Nincs orvosi, jogi vagy pénzügyi tanács
• Automatikusan beillesztett disclaimer‑ek
• Tartalomszűrés

Amikor az ügynök megjeleníti az értelmezés szövegét a felhasználónak – tartsd meg a disclaimer‑t. Az a disclaimer mezőben van minden AI‑válaszban.

Az MCP‑hívások ugyanazon credit‑rendszeren keresztül mennek, mint a HTTP. Egyszerű lekérdezések (10 kredit) → chart (20) → szinátria (50) → AI‑értelmezés (50).

Személyes használatra (egy felhasználó, aki Claude‑nak kérdez) körülbelül 200–500 kredit havonta. Ingyenes tarifával bőven.

Production‑ügynök számára, több száz felhasználóval – számold a végpontok keverékét. Daily‑horoscope bot 1 000 felhasználóval = 1 000 × 20 × 30 = 600 000 kredit/hó → Pro csomag.

• AstroWay MCP npm‑en
• AI‑ügynökök és MCP: use case: teljes integrációs útmutató
• Horoscope & AI Interpretations API: termékoldal
• Gyors start: szerezz API‑kulcsot (ingyenes, 10 000 kredit/hó)