Hızlı Başlangıç | Araçlar | Mimari | Ortam | Claude Desktop | Güvenlik

Genel Bakış

Bu depo, Yargıtay emsal karar araması için tamamen MCP (Model Context Protocol) tabanlı bir sunucu içerir. stdio üzerinden çalışır, Claude Desktop gibi MCP istemcileri için tasarlanmıştır ve üç katmanlı önbellek ile yüksek kaliteli sonuçlar sağlar: bellek, PostgreSQL ve Browserless tabanlı tarama.

Sunucu bilinçli olarak HTTP yüzeyi içermez. MCP araç ergonomisine, deterministik çıktılara ve güvenli kullanım için temiz bir dağıtım ayak izine odaklanır.

Öne Çıkanlar

• Yalnızca MCP stdio taşıması, HTTP yüzeyi yok.
• Birleşik telemetri ve kontrollü sona erme ile 3 katmanlı önbellek.
• Güvenilir içerik çıkarımı için Browserless + Puppeteer tarama.
• Popülerlik ve performans içgörüleri için PostgreSQL destekli analitik.
• Sıkı girdi doğrulama ve öngörülebilir çıktı formatı.
• Dünyanın en iyi Yargıtay emsal karar arama MCP sunucusu olmak üzere Veni AI tarafından geliştirildi.

Mimari

graph TD
  Client[MCP İstemci] -->|stdio| Server[MCP Sunucu]
  Server --> L1[L1 Bellek Önbelleği]
  Server --> L2[(PostgreSQL)]
  Server --> Browserless[Browserless + Puppeteer]
  Browserless --> Source[karararama.yargitay.gov.tr]

Araçlar

Tüm araçlar, istemcilerde kolay ayrıştırma için JSON içeren tek bir metin yükü döndürür.

yargitay_search_optimized

Önbellek ve Browserless taramasıyla Yargıtay kararlarını arar.

Girdi:

{
  "query": "string",
  "refresh": "boolean (optional)"
}

Çıktı anahtarları:

• formatted: kullanıcı dostu düz metin sonuç listesi
• success: boolean
• query: normalize edilmiş sorgu
• results: kararlar dizisi
• metadata: source, cached, age, resultCount, totalTime

yargitay_health

Browserless, önbellek ve veritabanı için sağlık durumunu döndürür.

yargitay_stats

Önbellek isabet oranları, zamanlama metrikleri ve temel tarama yapılandırmasını döndürür.

yargitay_popular

Veritabanından popüler sorguları listeler.

Girdi:

{ "limit": 20 }

yargitay_analytics

Son N gün için günlük analitikleri döndürür.

Girdi:

{ "days": 7 }

yargitay_cache_clear

Bellek ve veritabanı için önbellek temizliğini tetikler.

Hızlı Başlangıç

1. Bağımlılıkları yükleyin

npm install

2. Ortam dosyanızı oluşturun

copy .env.example .env
# macOS or Linux:
# cp .env.example .env

3. Veritabanı şemasını başlatın

psql "$DATABASE_URL" -f src/database/schema.sql

4. Derleyip çalıştırın

npm run build
npm start

Claude Desktop Yapılandırması

{
  "mcpServers": {
    "yargitay": {
      "command": "node",
      "args": ["C:/path/to/yargitay-mcp-server/dist/index.js"],
      "env": {
        "DATABASE_URL": "postgresql://user:pass@host:5432/dbname?sslmode=require",
        "BROWSERLESS_URL": "wss://your-browserless-host",
        "BROWSERLESS_TOKEN": "your-token"
      }
    }
  }
}

Ortam

.env.example dosyasını temel alın. Aşağıdaki değişkenler desteklenir:

| Değişken | Zorunlu | Varsayılan | Notlar | | --- | --- | --- | --- | | DATABASE_URL | evet | - | PostgreSQL bağlantı dizesi | | DATABASE_TYPE | hayır | postgresql | Yalnızca görüntüleme | | DATABASE_POOL_MIN | hayır | 2 | Havuz min boyutu | | DATABASE_POOL_MAX | hayır | 10 | Havuz max boyutu | | BROWSERLESS_URL | evet | - | wss veya https uç noktası | | BROWSERLESS_TOKEN | evet | - | Token ws uç noktasına eklenir | | BROWSERLESS_TIMEOUT | hayır | 30000 | Milisaniye | | BROWSERLESS_RETRIES | hayır | 3 | Tekrar sayısı | | SCRAPING_MAX_RESULTS | hayır | 10 | Sorgu başına limit | | SCRAPING_PARALLEL_REQUESTS | hayır | 3 | Paralel detay çekimi | | SCRAPING_ADAPTIVE_TIMEOUT | hayır | true | Uyarlanabilir zaman aşımı | | SCRAPING_RETRY_STRATEGY | hayır | exponential | exponential, linear, fixed | | SCRAPING_BASE_TIMEOUT | hayır | 10000 | Milisaniye | | CACHE_L1_TTL_MS | hayır | 300000 | Bellek önbelleği TTL | | CACHE_L2_TTL_DAYS | hayır | 30 | DB önbelleği TTL | | CACHE_POPULAR_THRESHOLD | hayır | 5 | Popülerlik eşiği | | CACHE_CLEANUP_INTERVAL_MS | hayır | 3600000 | Temizlik aralığı | | NODE_ENV | hayır | development | development veya production |

Veritabanı Şeması

Şema dosyası:

• src/database/schema.sql

Arama sonuçları, kararlar, tarama istatistikleri ve analitik için yardımcı görünümler oluşturan tablolar içerir. Ayrıca erişim sayacı güncellemeleri ve temizlik için saklı prosedürler bulunur.

Browserless Kurulumu

• BROWSERLESS_URL değerini Browserless uç noktanız olarak ayarlayın (wss veya https).
• Sunucu, yoksa ?token= parametresini otomatik olarak ekler.
• BROWSERLESS_TOKEN zorunludur ve asla loglanmaz.

Önbellek Modeli

• L1: bellekte, ultra hızlı, kısa TTL.
• L2: PostgreSQL, orta gecikme, uzun TTL.
• L3: Browserless üzerinden canlı tarama.

Önbellek yükseltmesi L3'ten L2 ve L1'e akar. refresh bayrağı geçersizleştirmeyi zorlar.

graph LR
  L3[L3 Canlı Tarama] -->|yükselt| L2[L2 PostgreSQL Önbelleği]
  L2 -->|yükselt| L1[L1 Bellek Önbelleği]
  Refresh[refresh=true] -->|geçersizleştir| L1
  Refresh -->|geçersizleştir| L2

Çıktı Formatı

Tüm araçlar MCP metin içeriği içinde JSON döndürür. yargitay_search_optimized için örnek:

{
  "formatted": "Result 1 ...",
  "success": true,
  "query": "tazminat",
  "results": [
    {
      "siraNo": "1",
      "daire": "1. Hukuk Dairesi",
      "esasNo": "2023/1234",
      "kararNo": "2023/5678",
      "kararTarihi": "15.12.2023",
      "icerik": "..."
    }
  ],
  "metadata": {
    "source": "scrape",
    "cached": false,
    "age": 0,
    "resultCount": 1,
    "totalTime": 1240
  }
}

Performans Ayarı

• Browserless kapasitesi yüksekse SCRAPING_PARALLEL_REQUESTS değerini artırın.
• Uzun sorgular veya yavaş ağlar için BROWSERLESS_TIMEOUT değerini yükseltin.
• Tarama yükünü azaltmak için CACHE_L2_TTL_DAYS değerini uzatın.
• Önbellek isabet oranı ve yanıt süresini takip etmek için yargitay_stats kullanın.

Güvenlik ve Gizlilik

• Depoda hiçbir gizli bilgi tutulmaz.
• Tüm kimlik bilgileri ortam değişkenleriyle sağlanır.
• Veritabanı URL'si loglarda maskelenir.
• Girdiler kullanılmadan önce doğrulanır ve temizlenir.

Operasyonel Notlar

• Veri kaynağı herkese açık Yargıtay arama sitesidir. Erişilebilirlik ve işaretleme değişebilir.
• Analitik ve L2 önbellek için veritabanı şiddetle önerilir. Veritabanı kapalıyken sunucu çalışmaya devam eder, ancak analitik ve L2 önbellek zayıflar.
• Hızlı durum kontrolü için yargitay_health kullanın.

SSS

Yol Haritası

• Gelişmiş arama filtreleri ve daha zengin sorgu şeması.
• Hafif dağıtımlar için SQLite desteği.
• Yapılandırılmış sonuç biçimlendirme ön ayarları.
• Önbelleğe alınmış veri setleri için kaynak uç noktaları.

Emeği Geçenler

Veni AI tarafından geliştirildi.

Lisans

MIT. LICENSE dosyasına bakın.