Yargı MCP: Türk Hukuk Kaynakları için MCP Sunucusu

Word'den UDF'ye profesyonel dönüşüm için yeni uygulamam udfcevir.com adresinde!

Bu proje, çeşitli Türk hukuk kaynaklarına (Yargıtay, Danıştay, Emsal Kararlar, Uyuşmazlık Mahkemesi, Anayasa Mahkemesi - Norm Denetimi ile Bireysel Başvuru Kararları, Kamu İhale Kurulu Kararları, Rekabet Kurumu Kararları, Sayıştay Kararları, KVKK Kararları ve BDDK Kararları) erişimi kolaylaştıran bir FastMCP sunucusu oluşturur. Bu sayede, bu kaynaklardan veri arama ve belge getirme işlemleri, Model Context Protocol (MCP) destekleyen LLM (Büyük Dil Modeli) uygulamaları (örneğin Claude Desktop veya 5ire) ve diğer istemciler tarafından araç (tool) olarak kullanılabilir hale gelir.

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

🔗 Remote MCP Adresi: https://yargimcp.fastmcp.app/mcp

Claude Desktop ile Kullanım (Ücretli abonelik gerekir)

Claude Desktop'ı açın
Settings → Connectors → Add Custom Connector
Bilgileri girin:
- Name: Yargı MCP
- URL: https://yargimcp.fastmcp.app/mcp
Add butonuna tıklayın
Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım

Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın
MCP Servers seçeneğini seçin - MCP Store açılacak
Üstteki Manage MCP Servers butonuna tıklayın
View raw config seçeneğine tıklayın
mcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:

{
  "mcpServers": {
    "yargi-mcp": {
      "serverUrl": "https://yargimcp.fastmcp.app/mcp/",
      "headers": {
        "Content-Type": "application/json"
      }
    }
  }
}

💡 İpucu: Remote MCP sayesinde Python, uv veya herhangi bir kurulum yapmadan doğrudan Claude Desktop üzerinden Türk hukuk kaynaklarına erişebilirsiniz!

örnek

🎯 Temel Özellikler

🚀 YÜKSEK PERFORMANS OPTİMİZASYONU: Bu MCP sunucusu %61.8 token azaltma ile optimize edilmiştir (8,692 token tasarrufu). Claude AI ile daha hızlı yanıt süreleri ve daha verimli etkileşim sağlar.

Çeşitli Türk hukuk veritabanlarına programatik erişim için standart bir MCP arayüzü.
Kapsamlı Mahkeme Daire/Kurul Filtreleme: 79 farklı daire/kurul filtreleme seçeneği
Dual/Triple API Desteği: Her mahkeme için birden fazla API kaynağı ile maksimum kapsama
Kapsamlı Tarih Filtreleme: Tüm Bedesten API araçlarında ISO 8601 formatında tarih aralığı filtreleme
Kesin Cümle Arama: Tüm Bedesten API araçlarında çift tırnak ile tam cümle arama desteği
Aşağıdaki kurumların kararlarını arama ve getirme yeteneği:
- Yargıtay: Detaylı kriterlerle karar arama ve karar metinlerini Markdown formatında getirme. Dual API (Ana + Bedesten) + 52 Daire/Kurul Filtreleme + Tarih & Kesin Cümle Arama (Hukuk/Ceza Daireleri, Genel Kurullar)
- Danıştay: Anahtar kelime bazlı ve detaylı kriterlerle karar arama; karar metinlerini Markdown formatında getirme. Triple API (Keyword + Detailed + Bedesten) + 27 Daire/Kurul Filtreleme + Tarih & Kesin Cümle Arama (İdari Daireler, Vergi/İdare Kurulları, Askeri Yüksek İdare Mahkemesi)
- Yerel Hukuk Mahkemeleri: Bedesten API ile yerel hukuk mahkemesi kararlarına erişim + Tarih & Kesin Cümle Arama
- İstinaf Hukuk Mahkemeleri: Bedesten API ile istinaf mahkemesi kararlarına erişim + Tarih & Kesin Cümle Arama
- Kanun Yararına Bozma (KYB): Bedesten API ile olağanüstü kanun yoluna erişim + Tarih & Kesin Cümle Arama
- Emsal (UYAP): Detaylı kriterlerle emsal karar arama ve karar metinlerini Markdown formatında getirme.
- Uyuşmazlık Mahkemesi: Form tabanlı kriterlerle karar arama ve karar metinlerini (URL ile erişilen) Markdown formatında getirme.
- Anayasa Mahkemesi (Norm Denetimi): Kapsamlı kriterlerle norm denetimi kararlarını arama; uzun karar metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
- Anayasa Mahkemesi (Bireysel Başvuru): Kapsamlı kriterlerle bireysel başvuru "Karar Arama Raporu" oluşturma ve listedeki kararların metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme.
- KİK (Kamu İhale Kurulu): Çeşitli kriterlerle Kurul kararlarını arama; uzun karar metinlerini (varsayılan 5.000 karakterlik) sayfalanmış Markdown formatında getirme.
- Rekabet Kurumu: Çeşitli kriterlerle Kurul kararlarını arama; karar metinlerini Markdown formatında getirme.
- Sayıştay: 3 karar türü ile kapsamlı denetim kararlarına erişim + 8 Daire Filtreleme + Tarih Aralığı & İçerik Arama (Genel Kurul yorumlayıcı kararları, Temyiz Kurulu itiraz kararları, Daire ilk derece denetim kararları)
- KVKK (Kişisel Verilerin Korunması Kurulu): Brave Search API ile veri koruma kararlarını arama; uzun karar metinlerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme + Türkçe Arama + Site Hedeflemeli Arama (kvkk.gov.tr kararları)
- BDDK (Bankacılık Düzenleme ve Denetleme Kurumu): Bankacılık düzenleme kararlarını arama; karar metinlerini Markdown formatında getirme + Optimized Search + "Karar Sayısı" Targeting + Spesifik URL Filtreleme (bddk.org.tr/Mevzuat/DokumanGetir)
Karar metinlerinin daha kolay işlenebilmesi için Markdown formatına çevrilmesi.
Claude Desktop uygulaması ile fastmcp install komutu kullanılarak kolay entegrasyon.
Yargı MCP artık 5ire gibi Claude Desktop haricindeki MCP istemcilerini de destekliyor!

🚀 Claude Haricindeki Modellerle Kullanmak İçin Çok Kolay Kurulum (Örnek: 5ire için)

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.

⚙️ Claude Desktop Manuel Kurulumu

Ö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.
Claude Desktop Settings -> Developer -> Edit Config.

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"
      ]
    }
  }
}

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

🌟 Gemini CLI ile Kullanım

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

Ö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.
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
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"

🧠 Semantik Arama (Opsiyonel - OpenRouter API)

Yargı MCP, semantik arama özelliği ile kararları anlamsal olarak sıralayabilir. Bu özellik opsiyoneldir ve OPENROUTER_API_KEY ayarlandığında otomatik olarak etkinleşir.

Semantik Arama Nasıl Çalışır?

initial_keyword ile Bedesten API'den 100 karar çekilir
query ile bu kararlar embedding modeli kullanılarak anlamsal olarak sıralanır
En alakalı kararlar döndürülür

OpenRouter API Anahtarı Alma

OpenRouter sitesine gidin
Hesap oluşturun ve API anahtarı alın (ücretsiz kredi ile başlayabilirsiniz)

Claude Desktop için Yapılandırma

{
  "mcpServers": {
    "Yargı MCP": {
      "command": "uvx",
      "args": ["yargi-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-xxx..."
      }
    }
  }
}

5ire için Yapılandırma

Tool ayarlarında Environment Variables alanına ekleyin:

OPENROUTER_API_KEY=sk-or-v1-xxx...

Gemini CLI için Yapılandırma

{
  "mcpServers": {
    "yargi_mcp": {
      "command": "uvx",
      "args": ["yargi-mcp"],
      "env": {
        "OPENROUTER_API_KEY": "sk-or-v1-xxx..."
      }
    }
  }
}

💡 Not: OPENROUTER_API_KEY ayarlanmazsa semantik arama aracı görünmez, diğer 19 araç normal şekilde çalışmaya devam eder.

🛠️ Kullanılabilir Araçlar (MCP Tools)

Bu FastMCP sunucusu 19 temel MCP aracı + 1 opsiyonel semantik arama 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

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
get_bedesten_document_markdown(documentId: str): Bedesten API'den herhangi bir belgeyi Markdown formatında getirir (HTML/PDF → Markdown)

Emsal Karar Araçları (UYAP)

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

Uyuşmazlık Mahkemesi Araçları

search_uyusmazlik_decisions(icerik, ...): Uyuşmazlık Mahkemesi kararlarını çeşitli form kriterleriyle arar.
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

search_anayasa_unified(decision_type, keywords_all, ...): AYM kararlarını birleşik arama (Norm Denetimi + Bireysel Başvuru) - 4 araç → 2 araç optimizasyonu
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ı

search_kik_decisions(karar_tipi, ...): KİK (Kamu İhale Kurulu) kararlarını arar.
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)

📊 Kapsamlı İstatistikler & Optimizasyon Başarıları

🚀 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 temel araç + 1 opsiyonel semantik arama 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)

🌐 Web Service / ASGI Deployment

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

📜 Lisans

Bu proje MIT Lisansı altında lisanslanmıştır. Detaylar için LICENSE dosyasına bakınız.