Menambahkan Astrologi ke Agen AI Anda melalui MCP

Jika kamu telah bekerja dengan Claude Desktop selama setahun terakhir - kamu pasti telah melihat MCP (Model Context Protocol). Ini adalah standar terbuka Anthropic untuk menghubungkan alat eksternal ke model AI. Beberapa baris konfigurasi - dan Claude dapat mengakses sistem file, database, atau API apa pun.

Dalam posting ini - bagaimana menambahkan perhitungan astrologi ke agen AI melalui MCP. Waktunya - kurang dari 5 menit.

MCP - protokol yang digunakan model AI untuk memanggil alat. Bayangkan seperti “REST API untuk agen AI”:

• Server menampilkan alat (perhitungan, permintaan, tindakan)
• Klien (Claude Desktop, Cursor, agen kustom) mendeteksi dan memanggilnya
• Model itu sendiri menentukan kapan alat mana yang digunakan - berdasarkan permintaan pengguna

Server MCP dapat berupa lokal (jalankan sebagai subproses) dan jarak jauh (HTTP). Sebagian besar server lokal - diterbitkan di npm dan dijalankan melalui npx.

Server MCP AstroWay menampilkan 25 alat yang mencakup perhitungan astrologi dasar:

• natal_chart - carta natal lengkap
• synastry - keserasian dua orang
• transits - transisi saat ini ke carta natal
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits - interpretasi AI
• human_design - carta HD lengkap
• hd_incarnation_cross, hd_compatibility - fitur HD
• 12 lagi yang mencakup progresi, solar return, astrokartografi, rektifikasi

Daftar di astroway.info dan buat kunci API gratis (10.000 kredit/bulan, tanpa kartu).

File claude_desktop_config.json:

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

Tambahkan server AstroWay:

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

Setelah restart, kamu akan melihat ikon palu dengan 25 alat yang tersedia.

Sekarang, cukup berbicara dengan Claude menggunakan bahasa alami:

Kamu: Buat carta natal untuk seseorang yang lahir pada 14 Juli 1990 pukul 14:30 di Kiev. Apa artinya Matahari di Kanker di rumah 10?

Claude: Memanggil natal_chart dengan koordinat yang dipars, kemudian interpret_placement. Berikut adalah carta natal. Matahari di Kanker di rumah 10 menunjukkan…

Claude sendiri:

• mempars bahasa alami (kota → koordinat)
• memilih alat yang tepat
• memformat respons

Jika kamu membangun agen AI kustom (bukan Claude Desktop), server MCP juga dapat digunakan. Protokol didokumentasikan:

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

Sebagian besar kerangka kerja untuk agen (LangChain, LlamaIndex, dll.) memiliki dukungan bawaan untuk MCP.

Jika kamu tidak ingin biaya tambahan MCP - panggil API HTTP langsung dari agen:

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

Kelebihan MCP: deskripsi alat yang terstruktur, autodeteksi, pengolahan kesalahan yang standar. Kelebihan HTTP: lebih sederhana, bekerja di mana saja, tanpa subproses.

Ketika MCP dikonfigurasi, coba di Claude:

1. “Apa horoskop harian saya? Saya lahir pada 3 Oktober 1993 pukul 6 pagi di New York”.
2. “Hitung tipe Human Design saya. Saya lahir pada 22 April 1987 pukul 16:45 di London”.
3. “Bandungkan keserasian dua orang: saya (14 Juli 1990, Kiev) dan teman (22 Maret 1992, Paris)”.
4. “Apa transisi utama untuk saya hari ini? Berikan interpretasi”.
5. “Saya tidak tahu waktu lahir yang tepat. Apa yang ditunjukkan analisis sensitivitas untuk rentang ±30 menit?”

Claude sendiri akan memilih alat yang tepat, memanggil beberapa alat dalam rantai, dan memformat respons dengan bahasa manusia.

Alat interpretasi AI AstroWay (interpret_*, *_horoscope) memiliki fitur keamanan bawaan:

• Tidak ada saran medis, hukum, atau keuangan
• Disclaimer yang diinjeksi secara otomatis
• Filter konten

Ketika agen menampilkan teks interpretasi kepada pengguna - simpan disclaimer. Ini ada di bidang disclaimer setiap respons AI.

Panggilan MCP melewati sistem kredit yang sama seperti HTTP. Sampel sederhana (10 kredit) → carta (20) → sinastri (50) → interpretasi AI (50).

Untuk penggunaan pribadi (satu pengguna yang mengajukan pertanyaan kepada Claude) - sekitar 200-500 kredit per bulan. Tarif gratis sudah cukup.

Untuk agen produksi dengan ratusan pengguna - hitung tergantung pada campuran endpoint. Bot horoskop harian untuk 1.000 pengguna = 1.000 × 20 × 30 = 600.000 kredit/bulan → rencana Pro.

• AstroWay MCP di npm
• Agen AI dan MCP - use case - panduan integrasi lengkap
• Horoskop & Interpretasi AI API - halaman produk
• Memulai - dapatkan kunci API (gratis, 10.000 kredit/bulan)