Додай астрологію до свого AI-агента через MCP

Якщо працював із Claude Desktop останній рік - напевно бачив MCP (Model Context Protocol). Це відкритий стандарт Anthropic для підключення зовнішніх інструментів до AI-моделей. Кілька рядків конфігу - і Claude вміє звертатись до файлової системи, БД чи будь-якого API.

У цьому пості - як додати астрологічні обчислення до AI-агента через MCP. Часу - менше 5 хвилин.

MCP - протокол, яким AI-моделі викликають інструменти. Уяви як «REST API для AI-агентів»:

• Сервер виставляє інструменти (обчислення, запити, дії)
• Клієнт (Claude Desktop, Cursor, кастомний агент) їх виявляє й викликає
• Модель сама вирішує, коли який інструмент застосувати: на основі запиту користувача

MCP-сервери бувають локальні (запуск як підпроцес) і віддалені (HTTP). Більшість локальні - публікуються у npm і запускаються через npx.

MCP-сервер AstroWay виставляє 25 інструментів, що покривають основні астрологічні обчислення:

• natal_chart: повна натальна карта
• synastry: сумісність двох людей
• transits: поточні транзити на натальну карту
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits: AI-інтерпретації
• human_design: повна HD-карта
• hd_incarnation_cross, hd_compatibility: HD-фічі
• ще 12, що покривають прогресії, solar returns, астрокартографію, ректифікацію

Зареєструйся на astroway.info та створи безкоштовний API-ключ (10 000 кредитів/міс, без картки).

Файл claude_desktop_config.json:

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

Додай astroway-сервер:

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

Після рестарту побачиш іконку-молоток із 25 доступними інструментами.

Тепер просто говори з Claude природною мовою:

Ти: Побудуй натальну карту людині, народженій 14 липня 1990 о 14:30 у Києві. Що означає її Сонце в Раку в 10-му домі?

Claude: Викликає natal_chart із розпарсеними координатами, потім interpret_placement. Ось натальна карта. Сонце в Раку в 10-му домі вказує…

Claude сам:

• парсить природну мову (місто → координати)
• обирає правильний інструмент
• форматує відповідь

Якщо будуєш кастомного AI-агента (не Claude Desktop), MCP-сервер теж можна використати. Протокол задокументований:

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

// Список інструментів
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Виклик інструмента
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');

Більшість фреймворків для агентів (LangChain, LlamaIndex тощо) мають вбудовану підтримку MCP.

Якщо не хочеш накладних витрат MCP - дзвони HTTP-API напряму з агента:

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

// Використання в циклі агента
const chart = await callAstrowayTool('chart', birthData);

Плюси MCP: структуровані описи інструментів, автодетект, стандартизована обробка помилок. Плюси HTTP: простіше, працює будь-де, без підпроцесів.

Коли MCP налаштований, спробуй у Claude:

1. «Який у мене щоденний гороскоп? Я народився 3 жовтня 1993 о 6 ранку в Нью-Йорку».
2. «Розрахуй мій Human Design type. Народжений 22 квітня 1987 о 16:45 у Лондоні».
3. «Порівняй сумісність двох людей: я (14 липня 1990, Київ) і подруга (22 березня 1992, Париж)».
4. «Які головні транзити для мене сьогодні? Дай інтерпретацію».
5. «Я не знаю точного часу народження. Що показує sensitivity-аналіз для діапазону ±30 хв?»

Claude сам обере потрібні інструменти, злагоджено викличе кілька за ланцюжком та відформатує відповідь людською мовою.

AI-інтерпретаційні інструменти AstroWay (interpret_*, *_horoscope) мають вбудовані safety-guardrails:

• Жодних медичних, юридичних чи фінансових порад
• Auto-injected disclaimer’и
• Контентна фільтрація

Коли агент показує текст інтерпретації користувачеві - зберігай disclaimer. Він у полі disclaimer кожної AI-відповіді.

MCP-виклики проходять через ту саму credit-систему, що й HTTP. Прості вибірки (10 кредитів) → chart (20) → синастрія (50) → AI-інтерпретація (50).

Для особистого використання (один користувач, що ставить Claude питання) - десь 200–500 кредитів на місяць. Безкоштовного тарифу з лишком.

Для продакшн-агента на сотні користувачів - рахуй залежно від суміші ендпоінтів. Daily-horoscope-бот на 1 000 юзерів = 1 000 × 20 × 30 = 600 000 кредитів/міс → план Pro.

• AstroWay MCP у npm
• AI-агенти та MCP: use case: повний інтеграційний гайд
• Horoscope & AI Interpretations API: продуктова сторінка
• Швидкий старт: отримай API-ключ (безкоштовно, 10 000 кредитів/міс)