MCP ile AI Ajanınıza Astroloji Ekleyin

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

• Sunucu araçları (hesaplamalar, sorgular, eylemler) sunar
• İstemci (Claude Desktop, Cursor, özel ajan) bunları keşfeder ve çağırır
• Model kendisi hangi aracı ne zaman kullanacağına karar verir: kullanıcının isteğine göre

MCP sunucuları yerel (alt süreç olarak çalıştırma) ve uzak (HTTP) olabilir. Çoğu yerel olanlar npm’de yayınlanır ve npx ile çalıştırılır.

AstroWay MCP Sunucusu her API işlemi için birer araç sunar, npm paketinde 735, barındırılan sunucuda 843 adet, astroway_<grup>_<işlem> gibi adlarla:

• astroway_western_chart ve komşu araçlar haritalar, transitler, ilerlemeler ve dönüşümler için
• astroway_relational_* sinastri, kompozit ve grup haritaları için
• astroway_ai_interpret_natal, astroway_ai_interpret_synastry: AI yorumları
• Human Design, Vedik, Çin, Helenistik astroloji, tarot ve numeroloji grupları

Listeyi kısaltmak için tam katalog yerine tek bir alan sunucusu bağlayın, bkz. MCP yapılandırması

astroway.info adresinde kaydolun ve ücretsiz bir API anahtarı oluşturun (10.000 kredi/ay, kart gerekmez).

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şlattıktan sonra, AstroWay araçları sohut giriş alanındaki araçlar menüsünde görünecektir.

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

Siz: 14 Temmuz 1990, 14:30’da Kiev’de doğan bir kişinin doğum haritasını oluşturun. Güneşi 10. evde Yengeç burcunda ne anlama geliyor?

Claude: Ayrıştırılmış koordinatlarla natal_chart çağırır, sonra interpret_placement. İşte doğum haritası. Güneş 10. evde Yengeç burcunda…

Claude kendisi:

• doğal dili ayrıştırır (şehir → koordinatlar)
• doğru aracı seçer
• yanıtı biçimlendirir

Eğer özel bir AI ajanı (Claude Desktop değil) oluşturuyorsanız, MCP sunucusunu da kullanabilirsiniz. Protokol belgelenmiş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');

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

Çoğu ajan çerçevesi (LangChain, LlamaIndex vb.) yerleşik MCP desteklidir.

MCP’nin ek yükünü istemiyorsanız - ajandanızdan doğrudan HTTP-API çağırın:

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’nin artıları: yapılandırılmış araç açıklamaları, otomatik tespit, standartlaştırılmış hata işleme. HTTP’nin artıları: daha basit, her yerde çalışır, alt süreç yok.

MCP ayarlandığında, Claude’da şunları deneyin:

1. “Günlük falım nedir? 3 Ekim 1993, sabah 6’da New York’ta doğdum”.
2. “Human Design tipimi hesapla. 22 Nisan 1987, 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 için ana transitlerim neler? Bana bir yorum ver”.
5. “Doğum zamanımı tam bilmiyorum. ±30 dakikalık aralık için hassasiyet analizi ne gösteriyor?”

Claude doğru araçları seçer, bir zincirde birkaçını çağırır ve yanıtı insan diliyle biçimlendirir.

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

• Tıbbi, yasal veya finansal tavsiye yok
• Otomatik enjekte edilen sorumluluk reddi ifadeleri
• İçerik filtreleme

Ajan, kullanıcıya yorum metni gösterdiğinde - sorumluluk reddi ifadesini koruyun. Bu, her AI yanıtının disclaimer alanında bulunur.

MCP çağrıları, HTTP ile aynı kredi sisteminden geçer. Basit sorgular (10 kredi) → harita (20) → sinastri (50) → AI yorumu (50).

Kişisel kullanım için (bir kullanıcının Claude’a soru sorduğu) - ayda yaklaşık 200-500 kredi. Ücretsiz plan fazlasıyla yeterlidir.

Yüzlerce kullanıcılı üretim ajanı için - uç nokta karışımına göre hesaplayın. 1.000 kullanıcı için günlük fal botu = 1.000 × 20 × 30 = 600.000 kredi/ay → Pro planı.

• npm’deki AstroWay MCP
• AI Ajanları & MCP: kullanım örneği: tam entegrasyon kılavuzu
• Fal & AI Yorumlama API: ürün sayfası
• Hızlı Başlangıç: API anahtarı alın (ücretsiz, 10.000 kredi/ay)