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

Если jsi v posledním roce pracoval s Claude Desktop, určitě jsi viděl MCP (Model Context Protocol). Jedná se o otevřený standard Anthropic pro připojování externích nástrojů k AI modelům. Jen pár řádků konfigurace – a Claude umí přistupovat k souborovému systému, DB nebo jakémukoli API.

V tomto příspěvku – jak přidat astrologické výpočty do AI agenta přes MCP. Čas – méně než 5 minut.

MCP – protokol, pomocí kterého AI modely volají nástroje. Představ si to jako “REST API pro AI agenty”:

• Server vystavuje nástroje (výpočty, dotazy, akce)
• Klient (Claude Desktop, Cursor, vlastní agent) je objevuje a volá
• Model sám rozhoduje, kdy který nástroj použít: na základě požadavku uživatele

MCP servery mohou být lokální (spuštěné jako podproces) i vzdálené (HTTP). Většina lokálních je publikována na npm a spouštěna přes npx.

MCP server AstroWay vystavuje po jednom nástroji na každou operaci API, 735 v npm balíčku a 843 na hostovaném serveru, s názvy ve formátu astroway_<skupina>_<operace>:

• astroway_western_chart a související nástroje pro mapy, tranzity, progresie a návraty
• astroway_relational_* pro synastrii, kompozit a skupinové mapy
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI interpretace
• skupiny Human Design, védské, čínské, ellynistické astrologie, tarot a numerologie

Pro zkrácení seznamu připoj jeden doménový server místo celého katalogu, viz nastavení MCP

Zaregistruj se na astroway.info a vytvoř si bezplatný API klíč (10 000 kreditů/měsíc, bez 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_your_key_here"
      }
    }
  }
}

Po restartu se nástroje AstroWay objeví v menu nástrojů v poli vstupu chatu.

Teď stačí mluvit s Claude přirozeným jazykem:

Ty: Vytvoř natalní mapu člověku narozenému 14. července 1990 v 14:30 v Kyjevě. Co znamená jeho Slunce v Raku v 10. domě?

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

Claude sám:

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

Pokud stavíš vlastního AI agenta (ne Claude Desktop), můžeš také použít MCP server. Protokol je zdokumentován:

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

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

Pokud nechceš režijní náklady MCP – volaj 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();
}

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

Plusy MCP: strukturované popisy nástrojů, autodetekce, standardizovaná obsluha chyb. Plusy HTTP: jednodušší, funguje kdekoliv, bez podprocesů.

Když je MCP nastaven, vyzkoušej v Claude:

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

Claude sám vybere potřebné nástroje, koordinovaně zavolá několik po sobě a naformátuje odpověď lidským jazykem.

Nástroje AI interpretací AstroWay (interpret_*, *_horoscope) mají vestavěné safety-guardrails:

• Žádné medicínské, právní ani finanční rady
• Automaticky vkládané disclaimer’y
• Filtrace obsahu

Když agent ukazuje text interpretace uživateli – uchovávej disclaimer. Je v poli disclaimer každé AI odpovědi.

MCP volání procházejí stejným credit systémem jako HTTP. Jednoduché výběry (10 kreditů) → chart (20) → synastrie (50) → AI interpretace (50).

Pro osobní použití (jeden uživatel, který klade Claude otázky) – zhruba 200–500 kreditů za měsíc. Bezplatný tarif s přebytkem.

Pro produkčního agenta pro stovky uživatelů – počítej podle mixu endpointů. Daily-horoscope 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
• Horoscope & AI Interpretations API: produktová stránka
• Rychlý start: získej API klíč (zdarma, 10 000 kreditů/měsíc)