Dodaj astrologię do swojego agenta AI za pomocą MCP

Jeśli pracowałeś z Claude Desktop w ostatnim roku – na pewno widziałeś MCP (Model Context Protocol). To otwarty standard Anthropic do 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ć obliczenia astrologiczne do agenta AI przez MCP. Czas – mniej niż 5 minut.

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

• Serwer udostępnia narzędzia (obliczenia, zapytania, akcje)
• Klient (Claude Desktop, Cursor, własny agent) je wykrywa i wywołuje
• Model sam decyduje, kiedy którego narzędzia użyć: na podstawie zapytania użytkownika

Serwery MCP mogą być lokalne (uruchamiane jako podproces) lub zdalne (HTTP). Większość lokalnych – publikowane w npm i uruchamiane przez npx.

Serwer MCP AstroWay udostępnia po jednym narzędziu na każdą operację API, 735 w pakiecie npm i 843 na serwerze hostowanym, z nazwami w formacie astroway_<grupa>_<operacja>:

• astroway_western_chart i pokrewne narzędzia do wykresów, tranzytów, progresji i powrotów
• astroway_relational_* do synastrii, kompozytu i grupowych wykresów
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretacje AI
• grupy Human Design, wedyjskiej, chińskiej, hellenistycznej astrologii, tarota i numerologii

Aby skrócić listę, podłącz jeden serwer domenowy zamiast pełnego katalogu, zobacz ustawienia MCP

Zarejestruj się na astroway.info i utwórz darmowy 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 restarcie narzędzia AstroWay pojawią się w menu narzędzi w polu wprowadzania czatu.

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

Ty: Zbuduj kartę natalną osoby 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 przetworzonymi współrzędnymi, potem interpret_placement. Oto karta natalna. Słońce w Raku w 10. domu wskazuje…

Claude sam:

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

Jeśli budujesz własnego agenta AI (nie Claude Desktop), możesz również użyć serwera MCP. 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');

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

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

Jeśli nie chcesz dodatkowych kosztów MCP – wywołuj HTTP-API 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();
}

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

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

Gdy MCP jest skonfigurowany, wypróbuj w Claude:

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

Claude sam wybierze potrzebne narzędzia, spójnie wywoła kilka kolejno i sformatuje odpowiedź ludzkim językiem.

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

• Brak porad medycznych, prawnych czy finansowych
• Automatycznie wstawiane disclaimer’y
• Filtracja treści

Kiedy agent wyświetla tekst interpretacji użytkownikowi – zachowaj disclaimer. Jest on w polu disclaimer każdej odpowiedzi AI.

Wywołania MCP przechodzą przez ten sam system kredytów, co HTTP. Proste zapytania (10 kredytów) → wykres (20) → synastria (50) → AI‑interpretacja (50).

Do użytku osobistego (jeden użytkownik zadający Claude pytania) – około 200–500 kredytów miesięcznie. Bezpłatny plan z nadmiarem.

Dla agenta produkcyjnego obsługującego setki użytkowników – liczyć w zależności od mieszanki endpointów. Bot Daily‑horoscope dla 1 000 użytkowników = 1 000 × 20 × 30 = 600 000 kredytów/mies. → plan Pro.

• AstroWay MCP w npm
• AI‑agenci i MCP: use case: pełny przewodnik integracyjny
• Horoscope & AI Interpretations API: strona produktu
• Szybki start: uzyskaj klucz API (darmowo, 10 000 kredytów/mies.)