Menambahkan Astrologi ke Agen AI Anda melalui MCP

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

Di postingan ini - cara menambahkan perhitungan astrologi ke agen AI melalui MCP. Waktu kurang dari 5 menit.

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

• Server menyediakan alat (perhitungan, permintaan, aksi)
• Klien (Claude Desktop, Cursor, agen kustom) menemukan dan memanggilnya
• Model sendiri memutuskan kapan alat mana yang digunakan: berdasarkan permintaan pengguna

Server MCP dapat bersifat lokal (dijalankan sebagai subproses) atau remote (HTTP). Kebanyakan lokal - dipublikasikan di npm dan dijalankan melalui npx.

Server MCP AstroWay menyediakan satu alat per operasi API, 735 di paket npm dan 843 di server yang di-host, dengan nama seperti astroway_<grup>_<operasi>:

• astroway_western_chart dan alat terkait untuk chart, transit, progresi, dan kembali
• astroway_relational_* untuk sinastri, komposit, dan chart grup
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: interpretasi AI
• kelompok Human Design, Vedic, Cina, Hellenistik, tarot, dan numerologi

Untuk memperpendek daftar, hubungkan satu server domain alih-alih seluruh katalog, lihat pengaturan MCP

Daftar di astroway.info dan buat API key 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, alat AstroWay akan muncul di menu alat di bidang input chat.

Sekarang cukup berbicara dengan Claude menggunakan bahasa alami:

Kamu: Buat chart natal untuk orang yang lahir 14 Juli 1990 pukul 14:30 di Kyiv. Apa arti Matahari-nya di Cancer di rumah ke-10?

Claude: Memanggil natal_chart dengan koordinat yang di-parse, lalu interpret_placement. Ini chart natalnya. Matahari di Cancer di rumah ke-10 menunjukkan…

Claude sendiri:

• mem-parsing bahasa alami (kota → koordinat)
• memilih alat yang tepat
• memformat jawaban

Jika kamu membangun agen AI kustom (bukan Claude Desktop), server MCP juga dapat digunakan. Protokolnya 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');

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

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

Jika kamu tidak ingin biaya overhead MCP - panggil HTTP-API 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();
}

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

Keuntungan MCP: deskripsi alat yang terstruktur, deteksi otomatis, penanganan error yang terstandarisasi. Keuntungan HTTP: lebih sederhana, bekerja di mana saja, tanpa subproses.

Setelah MCP dikonfigurasi, coba di Claude:

1. “Apa horoskop harian saya? Saya lahir 3 Oktober 1993 pukul 6 pagi di New York.”
2. “Hitung tipe Human Design saya. Lahir 22 April 1987 pukul 16:45 di London.”
3. “Bandingkan kompatibilitas dua orang: saya (14 Juli 1990, Kyiv) dan teman (22 Maret 1992, Paris).”
4. “Apa transit 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 diperlukan, memanggil beberapa secara berurutan, dan memformat jawaban dalam bahasa manusia.

Alat interpretasi AI AstroWay (interpret_*, *_horoscope) memiliki safety-guardrails bawaan:

• Tidak ada saran medis, hukum, atau keuangan
• Disclaimer otomatis disisipkan
• Penyaringan konten

Ketika agen menampilkan teks interpretasi kepada pengguna - simpan disclaimer. Itu berada di field disclaimer setiap jawaban AI.

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

Untuk penggunaan pribadi (satu pengguna yang mengajukan pertanyaan ke Claude) - sekitar 200–500 kredit per bulan. Paket gratis cukup.

Untuk agen produksi dengan ratusan pengguna - hitung berdasarkan campuran endpoint. Bot daily-horoscope untuk 1 000 pengguna = 1 000 × 20 × 30 = 600 000 kredit/bulan → paket Pro.

• AstroWay MCP di npm
• AI-agen dan MCP: use case: panduan integrasi lengkap
• Horoscope & AI Interpretations API: halaman produk
• Panduan cepat: dapatkan API key (gratis, 10 000 kredit/bulan)