Додай астрологію до свого 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 виставляє по одному інструменту на кожну операцію API, 735 у npm-пакеті і 843 на хостованому сервері, з назвами виду astroway_<група>_<операція>:

• astroway_western_chart і сусідні інструменти для карт, транзитів, прогресій і повернень
• astroway_relational_* для синастрії, композиту й групових карт
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI-інтерпретації
• групи Human Design, ведичної, китайської, елліністичної астрології, таро й нумерології

Щоб скоротити список, підключіть один доменний сервер замість повного каталогу, див. налаштування MCP

Зареєструйся на 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"
      }
    }
  }
}

Після рестарту інструменти AstroWay з’являться в меню інструментів у полі вводу чату.

Тепер просто говори з 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');

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

Більшість фреймворків для агентів (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();
}

// Use in your agent loop
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 кредитів/міс)