Přidejte astrologii ke svému AI-agentovi prostřednictvím MCP

Pokud jsi v posledním roce pracoval s MCP (Model Context Protocol) v Clauda Desktop, určitě jsi ho viděl. Je to otevřený standard od Anthropicu pro připojení externích nástrojů k AI modelům. Stačí pár řádků konfigurace a Claude umí pracovat s file systémem, databázemi nebo jakýmkoli API.

V tomto článku se dozvíš, jak přidat astrologické výpočty do svého AI agenta pomocí MCP. Zabere to méně než 5 minut.

MCP je protokol, který AI modely používají k volání nástrojů. Představ si ho jako „REST API pro AI agenty“:

• Server vystavuje nástroje (výpočty, dotazy, akce)
• Klient (Claude Desktop, Cursor, vlastní agent) je objeví a zavolá
• Model sám rozhodne, který nástroj použít – na základě uživatelova dotazu

MCP servery mohou být buď lokální (spuštěné jako podproces) nebo vzdálené (HTTP). Většina z nich jsou lokální – publikují se na npm a spouští se přes npx.

MCP server AstroWay vystavuje 25 nástrojů, které pokrývají základní astrologické výpočty:

• natal_chart – kompletní nativní mapa
• synastry – kompatibilita dvou lidí
• transits – aktuální transity na nativní mapu
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits – AI interpretace
• human_design – kompletní HD mapa
• hd_incarnation_cross, hd_compatibility – HD funkce
• dalších 12 nástrojů pokrývajících progrese, solar returns, astrokartografii a rectifikaci

Zaregistruj se na astroway.info a vytvoř si zdarma API klíč (10 000 kreditů/měsíc, bez nutnosti platební karty).

Soubor claude_desktop_config.json:

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

Přidej astroway server:

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

Po restartu uvidíš ikonu kladiva s 25 dostupnými nástroji.

Teď už můžeš mluvit s Claudem přirozenou řečí:

Ty: Vytvoř nativní mapu pro člověka narozeného 14. července 1990 ve 14:30 v Kyjevě. Co znamená jeho Slunce v Raku v 10. domě?

Claude: Volá natal_chart s parsovanými souřadnicemi, poté interpret_placement. Tady je nativní mapa. Slunce v Raku v 10. domě naznačuje…

Claude sám:

• parsuje přirozený jazyk (město → souřadnice)
• vybere správný nástroj
• formátuje odpověď

Pokud stavíš vlastní AI agenta (ne Clauda Desktop), MCP server můžeš použít také. Protokol je dobře zdokumentovaný:

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

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

// Seznam nástrojů
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Volání nástroje
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');

Většina frameworků pro agenty (LangChain, LlamaIndex atd.) má vestavěnou podporu MCP.

Pokud nechceš mít režii s MCP, můžeš volat HTTP API přímo z agenta:

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

// Použití v agentově smyčce
const chart = await callAstrowayTool('chart', birthData);

Výhody MCP: strukturované popisy nástrojů, automatická detekce, standardizované zpracování chyb. Výhody HTTP: jednodušší, funguje všude, bez podprocesů.

Když je MCP nastavený, zkus v Claudu:

1. „Jaký mám dnes horoskop? Narodil jsem se 3. října 1993 v 6 hodin ráno v New Yorku.“
2. „Vypočítej mi můj typ Human Design. Narodil jsem se 22. dubna 1987 v 16:45 v Londýně.“
3. „Porovnej kompatibilitu dvou lidí: já (14. července 1990, Kyjev) a moje přítelkyně (22. března 1992, Paříž).“
4. „Jaké jsou hlavní transity pro mě dnes? Dej mi interpretaci.“
5. „Nevím přesný čas narození. Co ukazuje sensitivity analýza pro rozmezí ±30 minut?“

Claude sám vybere potřebné nástroje, zavolá jich několik v řadě a formátuje odpověď lidským jazykem.

AI interpretující nástroje AstroWay (interpret_*, *_horoscope) mají vestavěné safety guardrails:

• Žádné lékařské, právní ani finanční rady
• Automaticky vložené disclaimery
• Filtrování obsahu

Když agent ukazuje text interpretace uživateli – zachovej disclaimer. Je součástí pole disclaimer každé AI odpovědi.

MCP volání procházejí stejným systémem kreditů jako HTTP. Jednoduché dotazy (10 kreditů) → mapa (20) → synastrie (50) → AI interpretace (50).

Pro osobní použití (jeden uživatel, který se ptá Clauda) – zhruba 200–500 kreditů měsíčně. Bezplatný tarif to s přehledem pokryje.

Pro produkční agenty s stovkami uživatelů – spočítej podle směsi endpointů. Denní horoskop bot pro 1 000 uživatelů = 1 000 × 20 × 30 = 600 000 kreditů/měsíc → plán Pro.

• AstroWay MCP na npm
• AI agenti a MCP – use case – kompletní integrační průvodce
• Horoskop & AI interpretace API – produktová stránka
• Rychlý start – získej API klíč (zdarma, 10 000 kreditů/měsíc)