Bu bölüm, Yargı MCP aracını 5ire gibi Claude Desktop dışındaki MCP istemcileriyle kullanmak isteyenler içindir.

• Python Kurulumu: Sisteminizde Python 3.11 veya üzeri kurulu olmalıdır. Kurulum sırasında "Add Python to PATH" (Python'ı PATH'e ekle) seçeneğini işaretlemeyi unutmayın. Buradan indirebilirsiniz.
• Git Kurulumu (Windows): Bilgisayarınıza git yazılımını indirip kurun. "Git for Windows/x64 Setup" seçeneğini indirmelisiniz.
• uv Kurulumu:
  • Windows Kullanıcıları (PowerShell): Bir CMD ekranı açın ve bu kodu çalıştırın: powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"
  • Mac/Linux Kullanıcıları (Terminal): Bir Terminal ekranı açın ve bu kodu çalıştırın: curl -LsSf https://astral.sh/uv/install.sh | sh
• Microsoft Visual C++ Redistributable (Windows): Bazı Python paketlerinin doğru çalışması için gereklidir. Buradan indirip kurun.
• İşletim sisteminize uygun 5ire MCP istemcisini indirip kurun.
• 5ire'ı açın. Workspace -> Providers menüsünden kullanmak istediğiniz LLM servisinin API anahtarını girin.
• Tools menüsüne girin. +Local veya New yazan butona basın.
  • Tool Key: yargimcp
  • Name: Yargı MCP
  • Command:

    uvx yargi-mcp
    

  • Save butonuna basarak kaydedin.
• Şimdi Tools altında Yargı MCP'yi görüyor olmalısınız. Üstüne geldiğinizde sağda çıkan butona tıklayıp etkinleştirin (yeşil ışık yanmalı).
• Artık Yargı MCP ile konuşabilirsiniz.

1. Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.

2. Claude Desktop Settings -> Developer -> Edit Config.

3. Açılan claude_desktop_config.json dosyasına mcpServers altına ekleyin:

   {
     "mcpServers": {
       // ... (varsa diğer sunucularınız) ...
       "Yargı MCP": {
         "command": "uvx",
         "args": [
           "yargi-mcp"
         ]
       }
     }
   }

4. Claude Desktop'ı kapatıp yeniden başlatın.

Yargı MCP'yi Gemini CLI ile kullanmak için:

1. Ön Gereksinimler: Python, uv, (Windows için) Microsoft Visual C++ Redistributable'ın sisteminizde kurulu olduğundan emin olun. Detaylı bilgi için yukarıdaki "5ire için Kurulum" bölümündeki ilgili adımlara bakabilirsiniz.

2. Gemini CLI ayarlarını yapılandırın:

   Gemini CLI'ın ayar dosyasını düzenleyin:

   • macOS/Linux: ~/.gemini/settings.json
   • Windows: %USERPROFILE%\.gemini\settings.json

   Aşağıdaki mcpServers bloğunu ekleyin:

   {
     "theme": "Default",
     "selectedAuthType": "###",
     "mcpServers": {
       "yargi_mcp": {
         "command": "uvx",
         "args": [
           "yargi-mcp"
         ]
       }
     }
   }

   Yapılandırma açıklamaları:

   • "yargi_mcp": Sunucunuz için yerel bir isim
   • "command": uvx komutu (uv'nin paket çalıştırma aracı)
   • "args": GitHub'dan doğrudan Yargı MCP'yi çalıştırmak için gerekli argümanlar

3. Kullanım:

   • Gemini CLI'ı başlatın
   • Yargı MCP araçları otomatik olarak kullanılabilir olacaktır
   • Örnek komutlar:
     • "Yargıtay'ın mülkiyet hakkı ile ilgili son kararlarını ara"
     • "Danıştay'ın imar planı iptaline ilişkin kararlarını bul"
     • "Anayasa Mahkemesi'nin ifade özgürlüğü kararlarını getir"

Bu FastMCP sunucusu 19 optimize edilmiş MCP aracı sunar (token verimliliği için optimize edilmiş):

Yargıtay Araçları (Birleşik Bedesten API - Token Optimized)

Not: Yargıtay araçları token verimliliği için birleşik Bedesten API'ye entegre edilmiştir

Danıştay Araçları (Birleşik Bedesten API - Token Optimized)

Not: Danıştay araçları token verimliliği için birleşik Bedesten API'ye entegre edilmiştir

Birleşik Bedesten API Araçları (5 Mahkeme) - 🚀 TOKEN OPTİMİZE

1. search_bedesten_unified(phrase, court_types, birimAdi, kararTarihiStart, kararTarihiEnd, ...): 5 mahkeme türünü birleşik arama (Yargıtay, Danıştay, Yerel Hukuk, İstinaf Hukuk, KYB) + 79 daire filtreleme + Tarih & Kesin Cümle Arama
2. get_bedesten_document_markdown(documentId: str): Bedesten API'den herhangi bir belgeyi Markdown formatında getirir (HTML/PDF → Markdown)

Emsal Karar Araçları (UYAP)

1. search_emsal_detailed_decisions(keyword, ...): Emsal (UYAP) kararlarını detaylı kriterlerle arar.
2. get_emsal_document_markdown(id: str): Belirli bir Emsal kararının metnini Markdown formatında getirir.

Uyuşmazlık Mahkemesi Araçları

1. search_uyusmazlik_decisions(icerik, ...): Uyuşmazlık Mahkemesi kararlarını çeşitli form kriterleriyle arar.
2. get_uyusmazlik_document_markdown_from_url(document_url): Bir Uyuşmazlık kararını tam URL'sinden alıp Markdown formatında getirir.

Anayasa Mahkemesi Araçları (Birleşik API) - 🚀 TOKEN OPTİMİZE

1. search_anayasa_unified(decision_type, keywords_all, ...): AYM kararlarını birleşik arama (Norm Denetimi + Bireysel Başvuru) - 4 araç → 2 araç optimizasyonu
2. get_anayasa_document_unified(document_url, page_number): AYM kararlarını birleşik belge getirme - sayfalanmış Markdown içeriği

KİK (Kamu İhale Kurulu) Araçları

1. search_kik_decisions(karar_tipi, ...): KİK (Kamu İhale Kurulu) kararlarını arar.
2. get_kik_document_markdown(karar_id, page_number): Belirli bir KİK kararını, Base64 ile encode edilmiş karar_id'sini kullanarak alır ve sayfalanmış Markdown içeriğini getirir.

Rekabet Kurumu Araçları

    * search_rekabet_kurumu_decisions(KararTuru: Literal[...], ...) -> RekabetSearchResult: Rekabet Kurumu kararlarını arar. KararTuru için kullanıcı dostu isimler kullanılır (örn: "Birleşme ve Devralma").     * get_rekabet_kurumu_document(karar_id: str, page_number: Optional[int] = 1) -> RekabetDocument: Belirli bir Rekabet Kurumu kararını karar_id ile alır. Kararın PDF formatındaki orijinalinden istenen sayfayı ayıklar ve Markdown formatında döndürür.

• Sayıştay Araçları (3 Karar Türü + 8 Daire Filtreleme):

  • search_sayistay_genel_kurul(karar_no, karar_tarih_baslangic, karar_tamami, ...): Sayıştay Genel Kurul (yorumlayıcı) kararlarını arar. Tarih aralığı (2006-2024) + İçerik arama (400 karakter)
  • search_sayistay_temyiz_kurulu(ilam_dairesi, kamu_idaresi_turu, temyiz_karar, ...): Temyiz Kurulu (itiraz) kararlarını arar. 8 Daire filtreleme + Kurum türü + Konu sınıflandırması
  • search_sayistay_daire(yargilama_dairesi, web_karar_metni, hesap_yili, ...): Daire (ilk derece denetim) kararlarını arar. 8 Daire filtreleme + Hesap yılı + İçerik arama
  • get_sayistay_genel_kurul_document_markdown(decision_id: str): Genel Kurul kararının tam metnini Markdown formatında getirir
  • get_sayistay_temyiz_kurulu_document_markdown(decision_id: str): Temyiz Kurulu kararının tam metnini Markdown formatında getirir
  • get_sayistay_daire_document_markdown(decision_id: str): Daire kararının tam metnini Markdown formatında getirir

• KVKK Araçları (Brave Search API + Türkçe Arama):

  • search_kvkk_decisions(keywords, page, pageSize, ...): KVKK (Kişisel Verilerin Korunması Kurulu) kararlarını Brave Search API ile arar. Türkçe arama + Site hedeflemeli (site:kvkk.gov.tr "karar özeti") + Sayfalama desteği
  • get_kvkk_document_markdown(decision_url: str, page_number: Optional[int] = 1): KVKK kararının tam metnini sayfalanmış Markdown formatında getirir (5.000 karakterlik sayfa)

BDDK Araçları

* `search_bddk_decisions(keywords, page)`: BDDK (Bankacılık Düzenleme ve Denetleme Kurumu) kararlarını arar. **"Karar Sayısı" targeting** + **Spesifik URL filtreleme** (`bddk.org.tr/Mevzuat/DokumanGetir`) + **Optimized search**
* `get_bddk_document_markdown(document_id: str, page_number: Optional[int] = 1)`: BDDK kararının tam metnini **sayfalanmış Markdown** formatında getirir (5.000 karakterlik sayfa)

🚀 TOKEN OPTİMİZASYON BAŞARISI:

• %61.8 Token Azaltma: 14,061 → 5,369 tokens (8,692 token tasarrufu)
• Hedef Aşım: 10,000 token hedefini 4,631 token aştık
• Daha Hızlı Yanıt: Claude AI ile optimize edilmiş etkileşim
• Korunan İşlevsellik: %100 özellik desteği devam ediyor

GENEL İSTATİSTİKLER:

• Toplam Mahkeme/Kurum: 13 farklı hukuki kurum (KVKK dahil)
• Toplam MCP Tool: 19 optimize edilmiş arama ve belge getirme aracı
• Daire/Kurul Filtreleme: 87 farklı seçenek (52 Yargıtay + 27 Danıştay + 8 Sayıştay)
• Tarih Filtreleme: Birleşik Bedesten API aracında ISO 8601 formatında tam tarih aralığı desteği
• Kesin Cümle Arama: Birleşik Bedesten API aracında çift tırnak ile tam cümle arama ("\"mülkiyet kararı\"" formatı)
• Birleşik API: 10 ayrı Bedesten aracı → 2 birleşik araç (search_bedesten_unified + get_bedesten_document_markdown)
• API Kaynağı: Dual/Triple API desteği ile maksimum kapsama
• Tam Türk Adalet Sistemi: Yerel mahkemelerden en yüksek mahkemelere kadar

🏛️ Desteklenen Mahkeme Hiyerarşisi:

Yerel Mahkemeler → İstinaf → Yargıtay/Danıştay → Anayasa Mahkemesi
     ↓              ↓            ↓                    ↓
Bedesten API   Bedesten API   Dual/Triple API   Norm+Bireysel API
+ Tarih + Kesin + Tarih + Kesin + Daire + Tarih   + Gelişmiş
  Cümle Arama    Cümle Arama   + Kesin Cümle     Arama

⚖️ Kapsamlı Filtreleme Özellikleri:

• Daire Filtreleme: 79 seçenek (52 Yargıtay + 27 Danıştay)
  • Yargıtay: 52 seçenek (1-23 Hukuk, 1-23 Ceza, Genel Kurullar, Başkanlar Kurulu)
  • Danıştay: 27 seçenek (1-17 Daireler, İdare/Vergi Kurulları, Askeri Mahkemeler)
• Tarih Filtreleme: 5 Bedesten API aracında ISO 8601 formatı (YYYY-MM-DDTHH:MM:SS.000Z)
  • Tek tarih, tarih aralığı, tek taraflı filtreleme desteği
  • Yargıtay, Danıştay, Yerel Hukuk, İstinaf Hukuk, KYB kararları
• Kesin Cümle Arama: 5 Bedesten API aracında çift tırnak formatı
  • Normal arama: "mülkiyet kararı" (kelimeler ayrı ayrı)
  • Kesin arama: "\"mülkiyet kararı\"" (tam cümle olarak)
  • Daha kesin sonuçlar için hukuki terimler ve kavramlar

🔧 OPTİMİZASYON DETAYLARI:

• Anayasa Mahkemesi: 4 araç → 2 birleşik araç (search_anayasa_unified + get_anayasa_document_unified)
• Yargıtay & Danıştay: Ana API araçları birleşik Bedesten API'ye entegre edildi
• Sayıştay: 6 araç → 2 birleşik araç (search_sayistay_unified + get_sayistay_document_unified)
• Parameter Optimizasyonu: pageSize parametreleri optimize edildi
• Açıklama Optimizasyonu: Uzun açıklamalar kısaltıldı (örn: KIK karar_metni)

Yargı MCP artık web servisi olarak da çalıştırılabilir! ASGI desteği sayesinde:

• Web API olarak erişim: HTTP endpoint'leri üzerinden MCP araçlarına erişim
• Cloud deployment: Heroku, Railway, Google Cloud Run, AWS Lambda desteği
• Docker desteği: Production-ready Docker container
• FastAPI entegrasyonu: REST API ve interaktif dokümantasyon

Hızlı başlangıç:

# ASGI dependencies yükle
pip install yargi-mcp[asgi]

# Web servisi olarak başlat
python run_asgi.py
# veya
uvicorn asgi_app:app --host 0.0.0.0 --port 8000

Detaylı deployment rehberi için: docs/DEPLOYMENT.md