Dodaj astrologię do swojego agenta AI za pomocą MCP

Jeśli pracowałeś z Claude Desktop przez ostatni rok - pewnie widziałeś MCP (Model Context Protocol). To otwarty standard Anthropic dla podłączania zewnętrznych narzędzi do modeli AI. Kilka linijek konfiguracji - i Claude potrafi odwoływać się do systemu plików, bazy danych czy dowolnego API.

W tym poście - jak dodać astronomiczne obliczenia do agenta AI przez MCP. Czasu - mniej niż 5 minut.

MCP to protokół, którym modele AI wywołują narzędzia. Wyobraź sobie „REST API dla agentów AI”:

• Serwer udostępnia narzędzia (obliczenia, zapytania, akcje)
• Klient (Claude Desktop, Cursor, niestandardowy agent) je wykrywa i wywołuje
• Model sam decyduje, kiedy który narzędzie zastosować - na podstawie zapytania użytkownika

Serwery MCP mogą być lokalne (uruchamiane jako podproces) i zdalne (HTTP). Większość lokalnych jest publikowana w npm i uruchamiana za pomocą npx.

Serwer MCP AstroWay udostępnia 25 narzędzi, które pokrywają podstawowe obliczenia astronomiczne:

• natal_chart — pełna mapa urodzeniowa
• synastry — zgodność dwóch osób
• transits — bieżące tranzyty na mapę urodzeniową
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — interpretacje AI
• human_design — pełna mapa HD
• hd_incarnation_cross, hd_compatibility — funkcje HD
• jeszcze 12, które pokrywają progresje, powroty słoneczne, astrokartografię, rektyfikację

Zarejestruj się na astroway.info i utwórz bezpłatny klucz API (10 000 kredytów/mies, bez karty).

Plik claude_desktop_config.json:

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

Dodaj serwer AstroWay:

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

Po restartcie zobaczysz ikonę młotka z 25 dostępnymi narzędziami.

Teraz po prostu rozmawiaj z Claude w naturalnym języku:

Ty: Zbuduj mapę urodzeniową osobie urodzonej 14 lipca 1990 o 14:30 w Kijowie. Co oznacza jej Słońce w Raku w 10 domu?

Claude: Wywołuje natal_chart z rozparsowanymi współrzędnymi, potem interpret_placement. Oto mapa urodzeniowa. Słońce w Raku w 10 domu wskazuje…

Claude sam:

• parsuje naturalny język (miasto → współrzędne)
• wybiera odpowiednie narzędzie
• formatuje odpowiedź

Jeśli budujesz niestandardowego agenta AI (nie Claude Desktop), serwer MCP również można wykorzystać. Protokół jest udokumentowany:

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

// Lista narzędzi
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Wywołanie narzędzia
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');

Większość frameworków dla agentów (LangChain, LlamaIndex itp.) ma wbudowaną obsługę MCP.

Jeśli nie chcesz nakładnych kosztów MCP — wywołuj API-HTTP bezpośrednio 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();
}

// Użycie w cyklu agenta
const chart = await callAstrowayTool('chart', birthData);

Plusy MCP: zstrukturowane opisy narzędzi, autodetekcja, standaryzowana obsługa błędów. Plusy HTTP: prostsze, działa wszędzie, bez podprocesów.

Kiedy MCP jest skonfigurowany, spróbuj w Claude:

1. „Jaki jest mój codzienny horoskop? Urodziłem się 3 października 1993 o 6 rano w Nowym Jorku”.
2. „Oblicz mój typ Human Design. Urodziłem się 22 kwietnia 1987 o 16:45 w Londynie”.
3. „Porównaj zgodność dwóch osób: ja (14 lipca 1990, Kijów) i przyjaciel (22 marca 1992, Paryż)”.
4. „Jakie są główne tranzyty dla mnie dzisiaj? Podaj interpretację”.
5. „Nie znam dokładnej godziny urodzenia. Co pokazuje analiza wrażliwości dla zakresu ±30 minut?”

Claude sam wybiera odpowiednie narzędzia, łańcuchowo je wywołuje i formatuje odpowiedź w ludzkim języku.

Narzędzia interpretacyjne AI AstroWay (interpret_*, *_horoscope) mają wbudowane zabezpieczenia:

• Żadnych porad medycznych, prawnych czy finansowych
• Automatycznie wstawiane disclaimery
• Filtrowanie treści

Kiedy agent pokazuje tekst interpretacji użytkownikowi — zachowaj disclaimer. Jest on w polu disclaimer każdej odpowiedzi AI.

Wywołania MCP przechodzą przez tę samą system kredytów, co API-HTTP. Proste wywołania (10 kredytów) → mapa urodzeniowa (20) → synastry (50) → interpretacja AI (50).

Dla osobistego użytkowania (jeden użytkownik, który zadaje Claude pytania) — około 200–500 kredytów na miesiąc. Bezpłatnego planu wystarczy.

Dla agenta produkcyjnego na setki użytkowników — licz zależnie od mieszanki endpointów. Daily-horoscope-bot na 1 000 użytkowników = 1 000 × 20 × 30 = 600 000 kredytów/mies → plan Pro.

• AstroWay MCP w npm
• Agenci AI i MCP — use case — pełny przewodnik integracyjny
• Horoskop i interpretacje API — strona produktowa
• Szybki start — uzyskaj klucz API (bezpłatnie, 10 000 kredytów/mies)