MCP ile AI Ajanınıza Astroloji Ekleyin

Eğer son bir yıl içinde Claude Desktop ile çalıştıysan, muhtemelen MCP (Model Context Protocol) görmüşsündür. Bu, AI modellerinin dış araçlara bağlanmasını sağlayan Anthropic’in açık standardıdır. Birkaç satır yapılandırma ve Claude, dosya sistemine, veritabanına veya herhangi bir API’ye erişebilir.

Bu yazıda, AI aracına MCP aracılığıyla astrolojik hesaplamaları eklemeyi öğreneceksin. Süre: 5 dakikadan az.

MCP, AI modellerinin araçları çağırdığı bir protokoldür. Bunu “AI aracıları için REST API” olarak düşün:

• Sunucu, araçları (hesaplamalar, sorgular, eylemler) sunar
• İstemci (Claude Desktop, Cursor, özel aracı), bunları keşfeder ve çağırır
• Model, hangi aracı ne zaman uygulayacağını, kullanıcı isteğine bağlı olarak kendisi belirler

MCP sunucuları yerel (alt işlem olarak çalıştırma) ve uzaktan (HTTP) olabilir. Çoğu yerel sunucu, npm’de yayınlanır ve npx ile çalıştırılır.

AstroWay MCP Sunucusu, 25 aracı sunar ve temel astrolojik hesaplamaları kapsar:

• natal_chart — tam doğum haritası
• synastry — iki kişinin uyumu
• transits — doğum haritasına geçerli geçişler
• daily_horoscope, weekly_horoscope, monthly_horoscope, yearly_horoscope
• interpret_natal, interpret_synastry, interpret_transits — AI yorumları
• human_design — tam HD haritası
• hd_incarnation_cross, hd_compatibility — HD özellikleri
• 12 adet daha, ilerlemeleri, güneş dönüşlerini, astro-kartografiyi ve dikdörtgenleştirme işlemlerini kapsar

Astroway.info’da kaydolun ve ücretsiz API anahtarınızı (10.000 kredi/ay, kart gerekmez) oluşturun.

claude_desktop_config.json dosyası:

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

AstroWay sunucusunu ekleyin:

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

Yeniden başlatma işleminin ardından, 25 araçla birlikte çekiç simgesini göreceksin.

Şimdi sadece Claude ile doğal dilde konuş:

Sen: 14 Temmuz 1990’da 14:30’da Kiev’de doğan birine doğum haritasını oluştur. Yengeç burcunda 10. evdeki Güneş’in anlamı nedir?

Claude: natal_chart’i parse edilmiş koordinatlarla çağırır, ardından interpret_placement’i çağırır. İşte doğum haritası. Yengeç burcunda 10. evdeki Güneş, …

Claude kendisi:

• doğal dili parse eder (şehir → koordinatlar)
• doğru aracı seçer
• yanıtı formatlar

Eğer özel bir AI aracını oluşturuyorsan (Claude Desktop değilse), MCP sunucusunu da kullanabilirsin. Protokol belgelendirilmiştir:

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

// Araçların listesi
mcp.stdin.write(JSON.stringify({
  jsonrpc: '2.0',
  id: 2,
  method: 'tools/list',
}) + '\n');

// Araç çağırma
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');

Çoğu aracı çerçevesi (LangChain, LlamaIndex vb.) MCP’yi dahili olarak destekler.

Eğer MCP’nin ek maliyetini istemiyorsan, aracından doğrudan HTTP-API’ye çağırabilirsin:

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

// Aracın döngüsünde kullanımı
const chart = await callAstrowayTool('chart', birthData);

MCP’nin artıları: yapılandırılmış araç açıklamaları, otomatik algılama, standartlaştırılmış hata işleme. HTTP’nin artıları: daha basit, her yerde çalışır, alt işlemler olmadan.

MCP ayarlandıktan sonra, Claude’da dene:

1. “Benim günlük burcum nedir? 3 Ekim 1993’te 06:00’da New York’ta doğdum”.
2. “Benim Human Design tipimi hesapla. 22 Nisan 1987’de 16:45’te Londra’da doğdum”.
3. “İki kişinin uyumluluğunu karşılaştır: ben (14 Temmuz 1990, Kiev) ve arkadaşım (22 Mart 1992, Paris)”.
4. “Bugün benim için hangi ana geçişler var? Yorum yapın”.
5. “Doğum saatimi bilmiyorum. ±30 dakika aralığında duyarlılık analizi ne gösterir?”

Claude kendisi gerekli araçları seçer, bunları zincirleme olarak çağırır ve yanıtı insan diliyle formatlar.

AstroWay AI yorumlama araçları (interpret_*, *_horoscope), dahili güvenlik önlemlerine sahiptir:

• Tıbbi, hukuki veya mali tavsiyeler yoktur
• Otomatik olarak enjekte edilen açıklamalar
• İçerik filtreleme

Aracın, kullanıcıya AI yorumunu gösterdiğinde — açıklamayı saklayın. Bu, her AI yanıtının disclaimer alanındadır.

MCP çağrıları, aynı kredi sistemini kullanır gibi HTTP ile geçer. Basit örnekler (10 kredi) → doğum haritası (20) → sinastri (50) → AI yorumu (50).

Kişisel kullanım (tek kullanıcı, Claude’a soru soran) için — yaklaşık 200-500 kredi/ay. Ücretsiz tarifenin yeterli olması beklenir.

Üretimde binlerce kullanıcıya sahip bir aracı için — endpoint karışımınıza bağlı olarak hesaplayın. Daily-horoscope botu 1.000 kullanıcı için = 1.000 × 20 × 30 = 600.000 kredi/ay → Pro planı.

• AstroWay MCP npm
• AI aracıları ve MCP — kullanım durumu — tam entegrasyon kılavuzu
• Burç ve AI Yorumları API — ürün sayfası
• Hızlı Başlangıç — API anahtarınızı alın (ücretsiz, 10.000 kredi/ay)