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

✨ Profesyonel Sürüm Hazır: Yargı MCP Pro

Mevzuat ve içtihatı tek bir MCP sunucusunda birleştiren profesyonel sürüm yayında:

👉 https://yargi.betaspacestudio.com

🚨 SUNUCU YENİ ADRESE TAŞINDI

Yeni Remote MCP adresi: https://yargimcp.surucu.dev/mcp

Eski adres (https://yargimcp.fastmcp.app/mcp) artık kullanım dışıdır — yalnızca taşındığını bildiren bir uyarı tool’u döner.

Yapmanız gereken: MCP istemcinizdeki (Claude Desktop, 5ire, Google Antigravity, ChatGPT vb.) sunucu URL’sini yukarıdaki yeni adresle güncelleyin.

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ı, BDDK Kararları, BTK Kararları, GİB Özelgeleri ve Sigorta Tahkim Komisyonu 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.surucu.dev/mcp

⚠️ Eski adres https://yargimcp.fastmcp.app/mcp artık kullanım dışıdır — yalnızca taşındığını bildiren bir uyarı tool’u döner. Lütfen yukarıdaki yeni adresi kullanın.

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

1. Claude Desktop’ı açın
2. Settings → Connectors → Add Custom Connector
3. Bilgileri girin:
   • Name: Yargı MCP
   • URL: https://yargimcp.surucu.dev/mcp
4. Add butonuna tıklayın
5. Hemen kullanmaya başlayın! 🎉

Google Antigravity ile Kullanım (Lokal uv Kurulumu — Kopyala-Yapıştır)

Ön Gereksinimler: Bilgisayarınızda Python, uv (kurulum) ve Node.js (indir) kurulu olmalı. (Node.js yalnızca aşağıdaki kurulum komutunu çalıştırmak için gerekir; MCP’yi uvx çalıştırır.)

Aşağıdaki bloğun tamamını terminale yapıştırın. Komut, Antigravity’nin okuduğu ~/.gemini/config/mcp_config.json dosyasını sizin yerinize oluşturur/günceller (varsa diğer sunucularınız korunur):

macOS / Linux (Terminal):

node - <<'YARGI'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","config"),file=path.join(dir,"mcp_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp"]={command:"uvx",args:["yargi-mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp eklendi -> "+file);
YARGI

Windows (PowerShell):

@'
const fs=require("fs"),os=require("os"),path=require("path");
const dir=path.join(os.homedir(),".gemini","config"),file=path.join(dir,"mcp_config.json");
fs.mkdirSync(dir,{recursive:true});
let cfg={};try{cfg=JSON.parse(fs.readFileSync(file,"utf8"))}catch{}
if(typeof cfg!=="object"||cfg===null||Array.isArray(cfg))cfg={};
if(typeof cfg.mcpServers!=="object"||cfg.mcpServers===null)cfg.mcpServers={};
cfg.mcpServers["yargi-mcp"]={command:"uvx",args:["yargi-mcp"]};
fs.writeFileSync(file,JSON.stringify(cfg,null,2)+"\n");
console.log("yargi-mcp eklendi -> "+file);
'@ | node -

Komut yargi-mcp eklendi -> ... çıktısını verdiğinde kurulum tamamlanmıştır. Antigravity’yi (açıksa kapatıp) yeniden başlatın; yargi-mcp araçları otomatik yüklenir.

💡 İpucu: Lokal kurulumda hukuk kaynaklarına erişim doğrudan bilgisayarınızda uvx yargi-mcp ile çalışır; uzaktan sunucuya ihtiyaç duymaz.

Remote MCP Sorun Giderme

https://yargimcp.surucu.dev/mcp bir web sayfası değil, Streamable HTTP MCP uç noktasıdır. Tarayıcıda açınca veya düz curl ile GET isteği atınca 406 Not Acceptable ve Client must accept text/event-stream benzeri bir yanıt görmek normaldir; bu, sunucunun kapalı olduğu anlamına gelmez. MCP istemcisi Accept: application/json, text/event-stream başlığıyla JSON-RPC isteği göndermelidir.

Hızlı sağlık kontrolü için tarayıcıda şu adresleri açabilirsiniz:

• https://yargimcp.surucu.dev/health — servis sağlık durumu

Claude.ai veya başka bir istemci “araç yok” gibi davranırsa:

1. Connector’ı kaldırıp yeniden ekleyin.
2. URL olarak önce https://yargimcp.surucu.dev/mcp deneyin; istemciniz yönlendirmeleri takip etmiyorsa https://yargimcp.surucu.dev/mcp/ deneyin.
3. Eski https://yargimcp.fastmcp.app/mcp adresinin istemci ayarlarında veya önbellekte kalmadığından emin olun.
4. İstemcinin remote/Streamable HTTP MCP desteklediğini ve text/event-stream kabul ettiğini kontrol edin.

---

🎯 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)
  • BTK (Bilgi Teknolojileri ve İletişim Kurumu): Kurul Kararlarını arama (anahtar kelime + karar no + karar tarihi + yayın tarihi + ilgili birim filtreleri); karar PDF’lerini (5.000 karakterlik) sayfalanmış Markdown formatında getirme (btk.gov.tr)
  • GİB (Gelir İdaresi Başkanlığı) Özelgeleri: Resmi vergi özelgelerini arama (18.000+ özelge: KDV, Kurumlar, Gelir, ÖTV, Damga vb.); tam metni sayfalanmış Markdown formatında getirme + Keyword + Özelge No + Kanun No + Tarih Aralığı + Otomatik ISO 8601 Dönüşümü + Metadata Başlık Bloğu
  • Sigorta Tahkim Komisyonu: Hakem Karar Dergisi (64 sayı, 2010-2025) içindeki sigorta tahkim kararlarını arama; dergi PDF’lerini Markdown formatında getirme + Sayı İçi Karar Arama + Türkçe Büyük/Küçük Harf Desteği + Relevance Scoring

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

---

---

---

---

---

---

---

📜 Lisans

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