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.

Related MCP server: Entscheidsuche MCP Server

🚀 5 Dakikada Başla (Remote MCP)

✅ Kurulum Gerektirmez! Hemen Kullan!

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

Claude Desktop ile Kullanım

1. Claude Desktop'ı açın

2. Settings → Connectors → Add Custom Connector

3. Bilgileri girin:

   • Name: Yargı MCP

   • URL: https://yargimcp.fastmcp.app/mcp

4. Add butonuna tıklayın

5. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım

1. Agent session açın ve editörün yan panelindeki "…" dropdown menüsüne tıklayın

2. MCP Servers seçeneğini seçin - MCP Store açılacak

3. Üstteki Manage MCP Servers butonuna tıklayın

4. View raw config seçeneğine tıklayın

5. mcp_config.json dosyasına aşağıdaki yapılandırmayı ekleyin:

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

🎯 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!

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

  • 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"

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?

1. initial_keyword ile Bedesten API'den 100 karar çekilir

2. query ile bu kararlar embedding modeli kullanılarak anlamsal olarak sıralanır

3. En alakalı kararlar döndürülür

OpenRouter API Anahtarı Alma

1. OpenRouter sitesine gidin

2. Hesap oluşturun ve API anahtarı alın (ücretsiz kredi ile başlayabilirsiniz)

Claude Desktop için Yapılandırma

5ire için Yapılandırma

Tool ayarlarında Environment Variables alanına ekleyin:

Gemini CLI için Yapılandırma

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

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

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)

3. search_emsal_detailed_decisions(keyword, ...): Emsal (UYAP) kararlarını detaylı kriterlerle arar.

4. get_emsal_document_markdown(id: str): Belirli bir Emsal kararının metnini Markdown formatında getirir.

Uyuşmazlık Mahkemesi Araçları

5. search_uyusmazlik_decisions(icerik, ...): Uyuşmazlık Mahkemesi kararlarını çeşitli form kriterleriyle arar.

6. 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

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

8. 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ı

9. search_kik_decisions(karar_tipi, ...): KİK (Kamu İhale Kurulu) kararlarını arar.

10. 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ı

🚀 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:

⚖️ 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ıç:

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.